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CONVENTIONS USED IN THIS MANUAL 



NOTATION 



DESCRIPTION 



COMMAND Commands are shown in CAPITAL LETTERS . The names must contain no blanks 

and must be delimited by a nonalphabetic character (usually a blank). 

KEYWORDS Literal keywords, which you enter as you need them but exactly as specified, appear 

in CAPITAL LETTERS. 

parameter Required parameters, for which you must substitute a value, appear in standard 

italics and stand alone: they are not delimited by brackets or by braces. 

[parameter] Optional parameters, for which you may substitute a value, appear in standard 

italics and are delimited by brackets [ J. 

An element inside brackets is optional. Several elements stacked inside a pair of 
brackets means the user may select any one or none of these elements. 
Example: [ A ] 



[ B ] 



user may select A or B or neither. 



When brackets are nested, parameters in inner brackets can only be specified if 
parameters in outer brackets or comma place-holders are specified. 
Example: [parml \Mparm2 \Mparm3] ] ] may be entered as: 



parml i parm2 t parm3 or 
parml t) parm3 or 
, ,parm3 , etc. 

Shaded delimiters appear in syntax diagrams to emphasize the role of the delimiter. 
Shading signifies that the delimiter preceding a parameter must be used for one of 
two reasons. 



(1) You have chosen to use the parameter, and the parameter requires the 
presence of the delimiter. 

(2) You have chosen to use more than one of the parameters in a chain of 
parameters that are connected by commas; and 

You have chosen to leave gaps in the chain of parameters by omitting one or 
more intermediate parameters. The gaps created by the omission of the 
intermediate parameters must be delimited (separated) to maintain the correct 
(ordered) position of the remaining parameters. 
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CONVENTIONS (Continued) 



< > 



user input 
superscript 

[BREAK! 

<< COMMENT >> 

** Comment ** 



Example: iterralMitemb liitemc]] 

means that the following are allowed: 

itema 

itema, itemb 
itema, itemb, itemc 
itema, itemc 

When several elements are stacked within braces the user must select one of these 
elements. 

) n { user must select A or B. 

An ellipsis indicates that a previous bracketed element may be repeated, or that 
elements have been omitted. 

In examples of interactive dialog, user input is underlined. 
Example: NEW NAME? ALPHA1 

c c 

Control characters are indicated by a superscript . Example: Y . (Press Y and the 

CNTL key simultaneously.) 

[BREAK) indicates a terminal key. The legend appears inside. 
Programmer's comments in listings appear within < < > > . 
Editor's comments appear in this form. 
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PREFACE 



This updated edition of the MPE V Commands manual puts all of the MPE commands within easy reach, 
in a single volume. Whether you are a System Operator, a System Manager, an Account Manager, or you 
are just getting used to your HP 3000, you will find all of the fundamental commands provided by MPE 
in this one reference. 

The commands are arranged alphabetically. If a particular command requires special capabilities, (SM, 
OP, AM, etc), those capabilities are mentioned in the "USE" description for that command. 

You will find references to data communications in the commands that "bridge" into the NS/3000 
AdvanceNet subsystem or into the DS/3000 subsytem (:FILE and : RESET). AdvanceNet and DS/3000 
are not part of the MPE fundamental operating system and must be purchased separately. The data 
communications parameters for :FILE and : RESET are presented in order to provide a full and accurate 
representation of the command syntax. Omitting those parameters will not hinder your use of those 
commands. Attempting to use those parameters if your system does not support data communications will 
produce an error. 

This release, G. 03.04 (V-Delta-4) supports Access Control Definitions (ACDs) which provide new security 
features for MPE V. The parameters available to manipulate ACDs are described under the greatly 
expanded : ALTSEC command. 

Like its predecessors, this edition, is divided into three sections: an introduction, a reference section 
documenting each user command, and a discussion of user defined commands (UDCs). The 
"ADDITIONAL DISCUSSION" section of each command may also list additional references should you 
need further help. 

The following documentation may also be helpful: 

• MPE V Intrinsics Reference Manual (32033-90007) 

• MPE File System Reference Manual (30000-90236) 

• MPE V Utilities Reference Manual (32033-9G008) 

• MPE V Storing and Restoring Files (32033-901 33) 

• MPE V System Backup and Recovery (32022-901 34) 

• MPE V Account Structure and Security (32033-901 36) 

• MPE V System Operator and Resource Management Reference Manual (32033-90005) 

• HP Advance Net NS/3000 User/Programmer Reference Manual (32344-90001) 

• "Communicator 3000", Volume 2, Issue 11 (5958-3145) 

• MPE V Account Structure and Security (32033-901 36) 
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MPE commands allow you to start, control, and stop the processing of programs and to request various 
other system operations. You generally use them to perform functions external to the source-language 
programs that you write, although many such functions support your programs. For example, you will use 
commands to: 

• Initiate an interactive session ( : HELLO command) or batch job ( : JOB command). 

• Display status information about sessions and jobs in the system ( : SHOWJOB). 

• Create, save, and delete files (: BUILD, :SAVE, and : PURGE, respectively); specify and list their 
characteristics (:FILE and :LISTF); dump them to tape or serial disc and subsequently restore 
them to the system (: STORE and : RESTORE); and specify security provisions for them (rALTSEC 
: RELEASE and : SECURE). 

• Handle programs; compile (: FORTRAN, :FTN77, : COBOL, :COBOLII, : PASCAL, :RPG, rBBASIC, 
: SPL), prepare those programs (: PREP), and execute them (: RUN). 

• Determine the status of devices ( : SHOWDEV and : DSTAT). 

• Determine the status of devicefiles, which are disc files originating on or destined for nonsharable 
devices (:SHOWIN and tSHOWOUT). 

• Communicate with other users ( : TE LL) and with the System Operator ( : TE L LOP). 

• Define your own commands ( : S ETC ATA LOG). 

• Access private disc volumes ( : MOUNT and : DISMOUNT). 

• Obtain assistance in using the Command Interpreter ( : HELP). 

Many other commands and functions are available as well. Complete specifications for the MPE 
commands appear in Section II. 



HOW TO USE THIS MANUAL 

The reference specifications for all MPE commands available to MPE users appear in Section II. For easy 
reference, they are presented alphabetically by command name. 

For each command, the reference specifications present the following information: 

• Command syntax. 

• Parameter definitions, including meaning, constraints, and defaults. 

• When and how the command may be used, such as; in jobs, sessions, during BREAK, or 
programmatically. 
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• Whether the command is interruptible with the [break) key. 

• Capability required: System Supervisor (OP), System Manager (SM), or Account Manager (AM), or 
whether the command must be executed at the Console. 

• Operation. A description of how to use the command, and any related special considerations. 

• An example. 

• Additional discussion, if any, in this or another manual. 

Many commands may be invoked under special circumstances during the execution of another operation, 
provided that the operation itself is "Breakable." For those commands, the "USE" description for the 
command will note that, "This command may be issued... in BREAK." You may suspend the execution of 
the current operation by pressing the (BREAK) key on the terminal or by calling the CAUSE BREAK intrinsic. 

Similarly, the notation "This command may be issued... from (in) a Program" appearing in the "USE" 
description indicates that the command is available through the COMMAND intrinsic. The CAUSEBREAK and 
COMMAND intrinsics are explained in the MPE V Intrinsics Reference Manual (32033-90007). 

The "USE" description also indicates whether special capabilities are required to execute the command and, 
if they are, which ones are required. The special capabilities you will encounter most often are: 

OP System Supervisor. A user whose account and username have been assigned OP capability. 

The System Supervisor is responsible for optimizing the performance of the system, and may 
execute commands like :TUNE and : ALLOCATE or logon with ;HIPRI. OP commands should 
not be confused with Operator commands, which are explained below. 

SM System Manager. A user whose account and username have been assigned SM capability. The 

System Manager creates the accounting structure and assigns to each account appropriate 
capabilities and initial security provisions. The System Manager also works with the Hewlett 
Packard Systems Engineering (SE) and the System Supervisor to develop the MPE configuration 
which best suits the needs of the users at their installation. 

AM Account Manager. A user, selected by the System Manager, whose username has been assigned 

AM capability. The Account Manager establishes groups and users within a particular account 
and assigns capabilities and attributes to them. 

CV Create Volumes capability. A capability assigned to accounts and usernames allows the user to 

create Private Volumes and access them. 

PS Programmatic Sessions. A user who is allowed to execute the : STARTS ESS command and to 

call to the STARTSESS and ABORTSESS intrinsics. This user is designated by the System 
Manager during the creation of SYSTART.PUB.SYS for the Startup State Configurator; or by 
an applications programmer who creates a turnkey system. 
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NM Node Manager. A user, selected by the System Manager, who is assigned to manage the data 

communication subsystem at a specified location. 

NA Network Administrator. A user, selected by the System Manager, who has been assigned the 

capability to perform comprehensive diagnostics on an entire communications network. 

Executing the commands in this manual does not require NM or NA capability. They are 
included to present a complete listing of the user capability list. Refer to the HP AdvanceNet 
NS/3000 User/Programmer Reference Manual (32344-90001). 

Many commands are more restricted in their use: they are noted in the "USE" description by the phrase, 
"...may be executed only from the Console...." These are Operator Commands. They do not require 
special capabilities, but they are usually executed only by the System Operator, who is logged on at the 
Console. With five notable exceptions, even Operator Commands may be made available to others users 
working at standard terminals. They become available only if the Operator specifically assigns 
(distributes) them to particular users. The five exceptions are =AB0RTI0, =AB0RTJ0B, =LOGON, =LOGOFF, 
and =SHUTDOWN. These five remain under the exclusive jurisdiction of the Console. 

Operator commands may be distributed to specific users, at the Operator's discretion, in two ways: with 
the : ALLOW command or with the : ASSOCIATE command. The : ALLOW command, as the name implies, 
gives users the ability to execute specific Operator commands at their own terminals. Any command 
normally executed at the System Console may be allowed, except those which can be entered only at the 
"=" prompt. These commands include: =L0G0N, =LOGOFF, =ABORTIO, =ABORTJ0B, =REPLY, RECALL, and 
=SHUTD0WN (These commands are console commands, since the System Console is the only device that will 
accept a A and display an "=" prompt in response.) :ALLOW should be used sparingly, because most 
Operator commands are powerful, and their use implies a high level of responsibility. 

The : ASSOCIATE command, the second way to distribute Operator capabilities, is more limited than the 
: ALLOW command. When a user is associated with a specific device class, he or she is granted operator 
control of any device belonging to that class. Before a user can be rASSOCIATEd, the username must be 
entered into a device/class user association table. This table is created by the System Manager with the 
ASOCTABL. PUB.SYS utility or the ASOCTABL5. PUB.SYS utility. 

Another method used to distribute Operator responsibilities is to transfer Console capabilities to another 
logical device, or Idev. (This is called "moving" the Console. Because the Console is a logical designation 
rather than a physical device, "moving" it requires only that the Console be assigned, using the : CONSOLE 
command, to a different Idev.) Moving the Console requires OP capability since the Console, and its 
capabilities, are privileged resources. In this sense, moving the Console is not so much a distribution of 
responsibility as it is a reassignment of responsibility to another user. The System Console is typically 
configured as Idev 20 and, under normal circumstances, should not be moved to another logical device. 

The reference specifications appearing in Section II cover the rules for entering each command. They 
show the command syntax and format; define the parameters, discuss constraints on and default values for 
them; provide an overview of the operation requested by the command; and present examples illustrating 
proper command entries. Parameter definitions common to more than one command are repeated for 
each applicable command. 
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COMMAND ELEMENTS 

Each MPE command consists of: 

• A colon prompt (supplied by the system during interactive sessions; the user must provide the 
prompt, usually an exclamation point (!) or another substitute, for batch jobs). 

• A command name (required in all cases). 

• A parameter list (used in most cases). 

A typical command including all three elements appears as follows: 

Prompt Parameter list Remote System Prompt Parameter list 

III III 

: RUN PROG,ENTRYX # RUN PROO.ENTRYX 

Command Command 

Prompt 

The prompt identifies a statement as an MPE command. In an interactive session, MPE displays the colon 
at the terminal whenever it is ready to accept a command. You respond by entering the remainder of the 
command after the colon. In a batch job, however, you may enter an exclamation point (!) or other 
characters to simulate the colon prompt, placing it in column one (1), and following it with the remainder 
of the command. 

Command Name 

The command name, which you enter following the colon, requests a specific operation. MPE prohibits 
embedded blanks within the name, and rejects the command if they appear. MPE interprets the next 
nonalphabetic character encountered as the end of the command name; typically this character is a blank. 
Blanks may appear between the colon and the command name except in the : HELLO, :JOB, and :DATA 
commands. 

Parameters 

The parameter list contains one or more options for the command. Parameters are required in some 
commands, but are optional or prohibited in others. Parameter lists can include positional parameters 
keyword parameter groups, or both, separated from each other by delimiters such as commas, semicolons, 
equal signs, or other punctuation marks. MPE permits both decimal and octal numbers as command 
parameters. Octal numbers are distinguished by their preceding percent sign (%). 

If a parameter is required, a value for it must be included in the parameter list. MPE substitutes default 
values for optional parameters that are omitted from the list. These default values are specified in the 
parameter definitions that accompany each command reference. 
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Normally, you must separate the parameter list from the command name by one or more blanks. When 
you omit the first optional positional parameter in a parameter list (refer to "POSITIONAL 
PARAMETERS" later in this section), you can begin the list with a comma, or other delimiter that 
normally follows the first parameter, and omit the first blank after the command name. The comma 
serves as a delimiter in place of blanks. Any delimiter within the parameter list can be surrounded by 
any number of blanks. 

Note that names of user defined commands (UDC's) may be composed of alphanumeric characters, but 
must begin with an alphabetic character. MPE commands contain only alphabetic characters. A string 
such as SHOWDEV6 is treated as a UDC, because the last character is numeric. If no UDC by that name 
exists, then because the last character is numeric, the command is passed to MPE with the numeric value 
(6 in this case) as a parameter. Normal MPE command syntax requires a space between the command and 
the parameter. In this case, the parameter is numeric, and SHOWDEV is a valid MPE command; in this case 
MPE is capable of separating the command from the parameter and will execute it accordingly. For more 
information, refer to Section III of this manual. 

The end of a command is indicated by the last nonblank character of the record in which it appears. For 
terminal input, a carriage return usually signals termination of command input. However, if the last 
nonblank character of the record is a continuation character, the command input is continued to the next 
record. For more information, refer to "Continuation Characters" in this section. 

POSITIONAL PARAMETERS. With positional parameters, the meaning of a parameter depends upon 
its position in the parameter list. For example, in the : FORTRAN command, the parameter list specifies the 
input file containing the source program, the output file to which the object code is written, and the 
output file to which the source listing is written, always in that order. In the following : FORTRAN 
command, the variable names INP, OUT, and *LST indicate the source, object, and listing, respectively: 

: FORTRAN INP,OUT.»LST 

(In the above example, the asterisk (*) in *LST is a special character denoting a backreference to a 
previously defined file. For more information, refer to "Backreferencing" in this section. 

Positional parameters are separated (delimited) from one another by commas. When you omit an optional 
positional parameter from within a list, you must include the comma that would normally follow that 
parameter. Two adjacent commas indicate a missing optional positional parameter. When you omit an 
optional positional parameter immediately following a command name, a comma becomes the first 
character in the parameter list. When you omit p ositional parameters from the end of the list, you need 
not include commas to signify this; the terminating [Return] or end-of -record is sufficient. The following 
examples demonstrate the proper omission of parameters from a command: 

.' FORTRAN INP,.«LST ** The parameter "OUT" is omitted. ** 

: FORTRAN ** All parameters omitted. ** 

KEYWORD PARAMETERS. You can enter keyword groups in any order with respect to each other. A 
keyword group consists of a keyword that denotes the group's meaning, sometimes followed by one or 
more subparameters. Each keyword group is preceded by a semicolon (;). When more than one 
subparameter appears in a group, they are usually separated from each other by commas. All delimiters 
can optionally be preceded or followed by blanks. The following example shows both positional and 
keyword parameters. INPT and OUTP are the positional parameters. DL and CAP are keywords. PH, DS, 
and MR are subparameters of the CAP keyword: 

; PREP INPT,OUTP;PL=500;CAP=PH,DS,MR 
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When both keyword groups and positional parameters form a list, positional parameters that are not 
associated with a keyword always precede the keyword groups. When you omit trailing parameters from 
the positional group, you need not include their delimiters. The occurrence of the first keyword signifies 
the termination of the positional group. When you omit optional subparameters from a keyword group, 
follow the same rules that apply to positional parameters. 

WILDCARD CHARACTERS. For some commands, you may substitute "wildcard characters" for certain 
parameters in the list. The wildcard characters count toward the eight character limit for user, group, 
account, and filenames. These wildcard characters have the following meanings: 

g Specifies one or more alphanumeric characters. When used by itself, @ 

denotes all members of the set. 

# Specifies one numeric character. 

? Specifies one alphanumeric character. 

These characters can be used as follows: 

ng Represents all items starting with the character "n". 

gn Represents all items ending with the character "n". 

ngx Represents all items starting with the character "n" and ending with the 

character "x". 

n####### Represents all items starting with the character "n" followed by seven 

digits. 

?ng Represents all items whose second character is "n". 

n? Represents all two -character items starting with the character "n". 

?n Represents all two-character items ending with the character "n". 

Syntax Conventions 

The syntax boxes which appear in the specifications for each command in Section II are included to 
illustrate parameter choices. Brackets ( [ ] ), which enclose separate groups of parameters, indicate the 
choice of that group is optional. 

Several elements may be stacked inside a pair of brackets. The user may select one or none of these 
elements. An ellipsis with three dots (...) signifies that the elements may be repeated. When brackets 
are nested, parameters in the inner brackets can only be specified if the parameters in the outer brackets 
or place holders are specified. Either a comma ( ,) or semicolon ( ;) may be a place holder, but they are not 
interchangeable and must be specified in the syntax. For example: 

:BASICPREP [conmandfile] Mlprogfile] [mlistfile]] 
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A sample of user choices includes: 

BASICPREP 

BASICPREP commandfile 
BASICPREP, progfile 
BASICPREP,, listfile 
BASICPREP, progf i le , 1 istf i le 

Braces ({ }) mean the elements contained are required. The user must select one of these elements. For 
example: 

•SAVE {$ 0LDPASS n new f ,ilere f erence } 
(tempf ilereference } 

In the example above, the user must enter either ": SAVE $OLDPASS,newf ilereference" or " : SAVE 
tempf ilereference" . ~~~ ~~ 

A combination of brackets and braces indicates mixed optional and required parameters. If the user 
desires the optional parameter, the user is required to chose only one of the elements in the braces. For 
example: 

<!° > 

:LISTF [filesetnjll, J] 

{1-1 > 
In this example, the user must specify 0, 1, 2 or -1, if this optional parameter is chosen. 

For further information, refer to "Conventions Used in this Manual" in the front of this manual. 



ENTERING COMMANDS 



You can enter commands through any standard input device, usually a terminal (for sessions) or a 
streamfile (for jobs). Each command is accepted by the MPE Command Interpreter (CI), which passes it 
to the appropriate system procedure for execution. Following execution, control returns to the Command 
Interpreter, which is now ready for another command. 



NOTE 



After completion of the execution of a command, the 
Command Interpreter prompts the input device for the next 
command. If this READ fails due to an I/O error, the CI 
tries to post another READ. If four consecutive READ 
attempts fail, the CI will log the user/ job off the system. 

All jobs and sessions have two system defined files, $STDIN and $STDLIST, associated with them. $STDIN 
is a filename indicating the standard input file from which the job or session is initiated. Commands and 
data are read from $STDIN by the Command Interpreter. $STDLIST is a filename indicating the standard 
listing or output file corresponding to the particular job or session. Command output, error messages, etc. 
are written to $STDLIST. For sessions, both $STDIN and $STDLIST are typically terminal devicefiles. 
For jobs, $STDIN is often a streamfile or a card reader; $STDLIST is often a spoolfile destined for a line 
printer. For more information, refer to the : STREAM command in Section II. 
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$STDLIST is said to be "duplicative" if the data read in from $STDIN is automatically echoed to 
$STDLIST. An example of this is a session on a CRT terminal. For more information on $STDIN and 
$STDLIST refer to "System Defined Files" in this section. 

In cases where $STDLIST is not duplicative, such as jobs where $STDLIST is a line printer, MPE echoes 
$STDIN to $STDLIST. For security reasons, MPE will strip all passwords and lockwords from $STDIN 
before echoing to $STDLIST. Any text following a "/" which could be interpreted as a lockword or 
password (e.g. eight or fewer alphanumeric characters, beginning with an alphabetic and delimited by a 
period, comma, semi-colon, or a blank) will not appear on $STDLIST, although MPE uses the full, original 
line for its command execution. 

Continuation Characters 

When the length of a command exceeds one record (for instance, one entry line on your terminal, or one 
source card), you may enter an ampersand (&) as the last nonblank character of the record and continue 
the command on the next record. The next record must begin with a colon, which is supplied 
automatically by MPE in interactive processing. In batch processing you must enter a colon or a special 
character to simulate the colon. You may embed blanks between the colon that begins the continuation 
record and the first nonblank character in the continuation record. In the following example, the 
command contains a continuation character at the end of the first line and an embedded blank at the 
beginning of the second: 

: RUN PROGB;NOPRIV;LMAP;STACK=501;PARM=5;& 
; DL=600;LIB=C 



Commands may contain a maximum of 278 characters exclusive of prompting colons and continuation 
ampersands. MPE does not permit a command name, keyword, positional parameter, or keyword 
subparameter to span more than one line. 

MPE does not begin interpretation of a command until the last record of the command is read. 

Interactive Session 

In interactive processing, users at terminals converse directly with the computer on a real time basis. This 
type of interaction is called a session. During a session, users are prompted for input. 

Executing Command Logon 

Another way to issue an MPE command is through the COMMAND LOGON capability. It is used to simplify 
the logon and logoff procedures when just one MPE command is to be executed. A COMMAND LOGON is 
performed by entering any MPE command and its parameter list, enclosed in parentheses, followed by the 
parameter list normally associated with the : HELLO command (user, account and group names). The 
following example shows how someone with the username MY NAME, and account name MYACCT, can logon 
to the system, execute a program called MY PROG, and log off, all in a single MPE command: 

: (RUN MYPROG) MYNAME. MYACCT 

For more information, refer to " : ( ) COMMAND LOGON" in Section II of this manual. 
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Batch Jobs 

A batch job is a file containing one or more commands, and, optionally, references to any data files needed 
for the job to successfully execute. The job file is processed independently of your session. It can be 
submitted from either a session, or another job. This technique, which uses the : STREAM command, is 
known as "streaming". 

Several jobs can be streamed at one time. They are selected for processing according to the input priority 
assigned when the job was streamed, and the job limit, or if it is a scheduled job, the time that you 
requested the job be introduced to the system. For more information, refer to : STREAM in Section II, and 
: STREAMS in the MPE V System Operation and Resource Management Reference Manual (32033-90005). 

Sequence Numbers in Job Files 

Spooled jobf iles may have sequence line numbers. MPE determines whether a jobf ile is sequenced or not 
by scanning the *JOB record. If the last eight columns of the :J0B record are numeric, the jobf ile is 
considered to be sequenced. MPE procedes to ignore the last eight columns of each record of every file 
associated with that particular job. 

There are certain implications associated with using a sequenced jobf ile. Ampersands (&) used as 
continuation characters must be placed before the sequence fields or they will not be read. Any programs 
that utilize sequence numbers for any purpose (i.e. continuity check when doing a serial data read) will 
not function properly as the sequence numbers will not be read. A file used as input to an editor must 
have no data in the sequence fields as these last eight bytes are not read. 

MPE commands in spooled jobs may have sequence line numbers. MPE determines whether a job is 
sequenced when it scans the : JOB record. If the last eight columns of the :J0B record are numeric, the 
job is considered sequenced. In sequenced jobs, only the : JOB record is required to have numeric data in 
the last eight columns. MPE does not check any subsequent records for numeric data, or even proper 
sequencing in the last eight columns; these columns are simply ignored. 

This definition of sequence numbers has certain implications. Ampersands (&) indicate continuationlines, 
and must be placed before, not after, sequence fields. Secondly, :JOB files may be numbered or 
unnumbered. If a file is numbered, MPE will strip the last eight bytes of each non-CI command record. 
The sequence of data records containing non-MPE commands will not be checked, and a program reading 
these records (data records) from $STDIN will never see the sequence numbers. 

Executing Commands Programmaticaily 

MPE allows you to execute nonprogram commands from within many subsystems. Refer to Table 1-1 for 
a list of nonprogram commands. You do this from the subsystem prompt by preceding the MPE command 
with a colon ( : ). For example: 



CONNECT-MINUTES 
COUNT LIMIT 

124250 ** 
29267 ** 



In this case the MPE command : REPORT was accessed from within the subsystem. 
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>: REPORT 










ACCOUNT 


FILESPACE- 


-SECTORS 


CPU- 


SECONDS 


/GROUP 


COUNT 


LIMIT 


COUNT 


LIMIT 


TECH PUBS 


39868 


50000 


247000 


** 


/SALES 
> 


11717 


«n 


92182 


## 
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Many MPE commands can be executed within programs using the COMMAND intrinsic. This intrinsic 
invokes the Command Interpreter and passes the MPE command for execution. Complete information on 
the COMMAND intrinsic appears in the MPE V Intrinsics Reference Manual (32033-90007). 



COMMAND ERRORS 

If you make an error while entering a command in an interactive session, MPE suppresses execution of the 
command and attempts to determine the cause of the error. MPE prints a caret {*■) under the incorrect 
part of the command, along with the appropriate message, and control is returned to your terminal. 

If you enter an erroneous command in a job file, and the preceding is not a : CONTINUE command, MPE 
will abort, or flush, the job. MPE prints an error message on the job's standard list device (usually the 
printer) so that you know which command caused the job to abort. However, if the erroneous command is 
preceded with the : CONTINUE command, MPE will report the error, and continue processing the job. For 
further information, refer to the : JOB, :EOJ, and : CONTINUE commands in Section 2. 

If a command is continued over several lines, and an error is detected, the offending line will be echoed, 
preceded by the line number on which the error has occurred. Note that when you use continuation 
characters, MPE reads all continued portions of the command entry as one line. In the following example, 
the filename includes a percent sign (%). File names must be alphanumeric, so a Command Interpreter 
error is generated: 

: FILE ABC& 
: =TAP%& 
: ;NEW 
(1)=TAP% 

UNEXPECTED CHARACTER IN FILE NAME; EXPECTED "." OR "/" . IS 
THE DELIMITER BETWEEN PARAMETERS CORRECT? (CIERR 582) 

The MPE : REDO command allows you to edit the last line that you entered. To use it, enter: REDO. The 
previous command will be echoed to your terminal. Using edit symbols, you can insert, delete, or replace a 
character, or undo a previous edit. If you do not use an edit symbol, MPE assumes that you want to 
replace one or more characters. For more information, refer to the : REDO command in Section II. 

MPE also provides an online HELP facility. To access the HELP subsystem, enter : HELP, or :HELP 
followed by the name of the command you want information about. The :HELP command has several 
optional parameters such as parms, operation, and example which can be very useful for obtaining only 
the desired information. For more information, refer to the :HELP command in Section II of this 
manual. 



INTERRUPTING COMMAND EXECUTION 

It is sometimes necessary to interrupt an executing MPE command to execute another command. 
Command interruption is accomplished by pressing (break] on your terminal (sometimes labeled 
"INTERRUPT" or "ATTENTION"). In some cases, pressing [BREAKl will cause the executing command to 
be suspended or aborted. In other cases, pressing [break! will have no effect. 
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The exact effect that pressing [break] will have on your executing command depends on whether the 
command is one that executes a subsystem or user program (program command), or whether the command 
does not execute such a program (nonprogram command). Table 1-1 indicates BREAKable and 
nonBREAKable nonprogram commands. Table 1-2 indicates BREAKable program commands. 

Table 1-1. Nonprogram Commands 



BREAKABLE NONBREAKABLE 


:ALTSEC :( 


) COMMAND LOGON : 


FILE :1 


R.EPLY/=REPLY 


:BYE : 


ABORT : 


FOREIGN : 


RESET 


•.HELLO (If there is no : 


ABORTIO/=ABORTIO : 


FREERIN : 


RESETACCT 


OPTION LOGON UDC*) : 


ABORTJOB/=ABORTJOB : 


GETLOG : 


RESETDUMP 


:HELP : 


ACCEPT : 


GETRIN : 


RESETDUMP 


:LISTACCT : 


ALLOCATE : 


GIVE : 


RESUME 


:LISTF : 


ALLOW : 


HEADOFF : 


RESUMEJOB 


: LISTGROUP : 


ALTACCT : 


HEADON 


RESUMELOG 


:LISTLOG : 


ALTGROUP : 


IF 


RESUMESPOOL 


:LISTUSER : 


ALTJOB : 


JOB 


SAVE 


:LISTVS : 


ALT LOG 


JOBFENCE 


SECURE 


:REDO 


ALTSPOOLFILE 


JOBPRI 


S ETC ATA LOG 


: REPORT 


ALTUSER 


JOBSECURITY 


SETDUMP 


: RESTORE 


ALTVEST 


LDISMOUNT 


SETJCW 


:RUN 


ASSOCIATE 


LIMIT 


SETMSG 


:SEGMENTER 


A UTOAL LOCATE 


LMOUNT 


SHOWCOM 


:SHOWAL LOCATE 


BUILD 


LOG 


SHOWLOG 


:SHOWALLOW 


CHANGELOG 


= LOGOFF 


SHOWLOGSTATUS 


:SH0WCATALOG 


COMMENT 


= LOGON 


SHOWTIME 


:SHOWDEV 


CONSOLE 


MOUNT 


=SHUTDOWN 


:SHOWIN 


CONTINUE 


NEWACCT 


SPEED 


:SHOWJCW 


DATA 


NEWGROUP 


STARTS POOL 


rSHOWJOB 


DEALLOCATE 


NEWUSER 


STOPS POOL 


rSHOWME 


DEBUG 


NEWVSET 


STREAMS 


:SHOWOUT 


DELETESPOOLFILE 


OUTFENCE 


SUSPENDS POOL 


:SHOWQ 


DISALLOW 


PASSWORD 


SWITCH LOG 


: STREAM 


SET 


. PTAPE 


•TAKE 


rSYSDUMP 


DEBUG 


: PURGE 


:TELL 


:TUNE 


DISASSOCIATE 


: PURGEACCT 


:TELLOP 


:VINIT 


: DISMOUNT 


: PURGEGROUP 


:UP 




:DOWN 


:PURGEUSER 


:VMOUNT 




: DOWN LOAD 


: PURGEVSET 


:VSUSER 




: DSTAT 


:RECALL/=RECALL 


:WARN 




:ELSE 


: REFUSE 


: WELCOME 




:ENDIF 


: RELEASE 






:E0D 


.RELLOG 






:EOJ 


: RENAME 
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Table 1-2. Program Commands (All Are Breakable) 





: BASIC 
BASICGO 
BASICOMP 
BASICPREP 
BBASIC 
BBASICGO 
BBASICOMP 
BBASICPREP 
COBOL 
COBOLGO 


: COBOLII tPASCALGO 
COBOLIIGO :PASCALPREP 

•COBOLII PREP :PREP 
COBOLPREP .-PREPRUN 
EDITOR :RPG 
FCOPY :RPGGO 
FORTGO :RPGPREP 
FORTPREP :SPL 
FORTRAN :SPLGO 
PASCAL :SPLPREP 

: STORE 



Interrupting Nonprogram Commands 
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If you respond YES to the "ABORT?" message, the Command Interpreter aborts the suspended program and 
executes the command you entered. 

If you log on using: ( ) COMMAND LOGON, with a program command inside the parentheses, and then 
respond YES to the "ABORT?" message, MPE aborts the command and logs you off immediately. 

If you respond NO to the "ABORT?" message, the Command Interpreter prints the message "COMMAND NOT 
ALLOWED IN BREAK. CIWARN (986)" and prompts you for another command. If you now enter 
: RESUME, the suspended program resumes at the point where it was interrupted. 



NOTE 



User programs are initiated with the BREAK facility 
enabled. You may programmatically disable the BREAK 
facility by using the FCONTROL intrinsic. Application 
programs can restrict user access to the Command 
Interpreter by disabling the BREAK function. For more 
information refer to the MPE V Intrinsics Manual 
(32033-90007). 



Note that [BREAK! / : ABORT and : RESUME are valid only in sessions, not in batch jobs. 

Aborting A Program 

When a program contains logical errors, such as an infinite loop, you can abort it by following the steps 
below: 

1. Pressing (BREAK). This suspends your program and MPE prompts you for a new command. 

2. When you receive a colon prompt, enter : ABORT. This terminates the program, but in no way 
disrupts the session. 

MPE confirms the termination of the program by displaying the following message and prompting 
you for a new command: 

PROGRAM ABORTED PER USER REQUEST (CIERR 989) 

You can also use the IJ3REAKJ/ : ABORT sequence to abort certain MPE subsystem and command 
operations. This capability is indicated in the Command Specifications, under the "USE" entry. 



FILES 

The file system has two general classes of files: 

• User Defined Files, which you or other users define, create, and make available for your own purposes. 

• System Defined Files, which the file system defines and makes available to all users to indicate 
standard input/output files. Refer to "System Defined Files" in this section for more information. 
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Files are identified by their filename which optionally may be followed by the group and/or account 
names that reference them. A fully qualified file identifier is one in which the filename is followed by 
the group and account names (e.g. myfile. group. account). You may use either the filename or the 
fully qualified file identifier within a program to identify any given file to the system. Any arbitrary 
name may also be used as a file identifier (formal file designator) providing the appropriate literal file 
identifier (actual file designator) is equated at run time. Any file identifier may contain from one to 
eight alphanumeric characters, but must begin with an alphabetic character. An actual file designator 
includes the filename, optionally followed by a lockword, the group name, and account name. For 
example: 

: FILE MYFILE/MY LOCK. GROUP. ACCOUNT 

Backreferencing 

Once you establish a set of specifications in a :FILE command, you can apply those specifications to other 
file references in your job or session simply by using the file's formal file designator preceded by an 
asterisk (*) in those references. For instance, suppose you use a :FILE command to establish the 
specifications shown below for the file FILEA used by program PROG A You then run PROGA You then 
wish to apply those same specifications to the file FILEB expected by PROGB, and run that program. You 
can use :FILE to equate the FILEA specifications to cover FILEB, as follows: 

: FILE FILEA;DEV=TAPE;REC=-80,4,V;BUF=4 ** Establishes specif ications. ** 

: RUN PROGA ** Runs program A. ** 

: FILE FILEB=«FILEA ** Backreferences specifications ** 

** for FILEA. ** 

: RUN PROGB ** Runs program B. ** 

This technique is called backreferencing, and the files to which it applies are known as user predefined 
files. Whenever you reference a predefined file in an MPE command, you must enter the asterisk before 
the file. This is done when using EDIT/ 3 000 in session mode if you wish to transmit the EDIT/3000 
offline listings to an offline device (such as a magnetic tape or line printer). Define the file in a :FILE 
command, and then specify the destination filename as a parameter in the : EDITOR command. Next, 
backreference the definition by using the asterisk in the : EDITOR command, as shown below: 

: FILE L;DEV=LP ** Specifies filenamed L as a line printer. ** 

: EDITOR «L ** Runs EDIT/3000, directs offline listing to L, ** 

** now established as a line printer. ** 

When backreferencing in a command, you cannot reference any predefined formal file designator of the 
subsystem you are using. FORTRAN predefines FTNTEXT as its formal file designator which cannot be 
backreferenced using the command: FORTRAN;* FTNTEXT. 

System Defined Files 

MPE reserves certain actual file designators for system defined files. These file designators can be used 
with file equations. Following is a list of these file designators and a description of the files they 
reference: 

$STDIN A filename indicating the standard job or session input file 

(from which the job or session is initiated). For a job, this is 
typically a spoolfile; for a session this typically indicates a 
terminal devicefile. 
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Introduction to Commands 



$STDINX 



$STDLIST 



$NULL 



$NEWPASS 



$OLDPASS 



In the $STDIN file, data (not command) entries should not 
contain colon or substitute prompts in the character one 
position. Use the : EOD command to indicate the physical end of 
a datafile. 

This is equivalent to $STDIN, except that MPE command entries 
(those with a colon in the character one position . ) encountered 
are read without indicating the end of data. (The commands 
: EOD and : : EOF : are exceptions that always indicate the end of 
data and are not read. ) 

A filename indicating the standard job or session listing file 
corresponding to the particular input device being used. (For 
each potential input device, corresponding listing device is 
defined during system configuration.) The listing device is 
customarily a printer for a batch job and a terminal for a 
session. 

The name of a nonexistent "ghost" file that is always treated as 
an empty file. When referenced as an input file by a program, 
that program receives only an end -of -file indication upon first 
access. When referenced as an output file, the associated write 
request is accepted by MPE but no physical output is actually 
performed. $NULL can be used to discard unneeded output from 
an executing program. 

A temporary disc file used by MPE to write to during command 
execution. Only one such file can exist in the job or session at 
any one time. 

The name of the temporary file last closed as $NEWPASS. 



The actual file designators $NEWPASS and $OLDPASS can be used when compiling and preparing a 
program. When compilation begins, the compiler issues instructions to the MPE file system to create a 
filenamed $NEWPASS. As compilation takes place, the compiler writes the translated code (the object 
code) to this new file. When compilation is complete, $NEWPASS is closed and renamed $OLDPASS. In this 
example, $OLDPASS is the User Subprogram Library (USL) file. 

When you prepare the USL file ( $OLDPASS), the prepared code is placed in $NEWPASS, just as the object 
code was placed in $NEWPASS in the compilation stage. When preparation is complete, $NEWPASS is 
closed, the USL file ( $OLDPASS) is purged, and $NEWPASS is then renamed $OLDPASS. Thus, $OLDPASS 
is now the program file, and can be executed. $OLDPASS can be made permanent by issuing the :SAVE 
command. For more information on file system operation refer to the MPE Segmenter Reference Manual 
(30000-9001 1) and the MPE File System Reference Manual (30000-90236). 
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The reference specifications for all MPE commands available to users appear in this section. For easy 
reference, they are presented alphabetically by command name. For each command, the reference 
specifications contain the following information: 

• Command syntax. 

• Parameter definitions, including meaning, constraints, and defaults. 

• When and how the command may be used, such as: in jobs, sessions, during BREAK, or 

programmatically. 

• Whether the command is interruptible with the [break) key. 

• Operation. A description of how to use the command, and any related special considerations. 

• An example. 

• Additional discussion, if any, in this or another manual. 



CAUTION 



If you have no prior experience with MPE, you should read 
Section I before attempting to use the reference 
specifications in this section. 



Some commands require special capabilities. Those capabilities are discussed in Section I, 
"INTRODUCTION TO COMMANDS". The most frequently cited capabilities are: OP, SM, AM, CV, PS, 

NM, and NA. 

Table 2- 1 presents a functional list of the commands found in this manual, along with a notation of any 
special capability required to execute each command. If no special capability is mentioned, you may 
assume that the command is available to any user at any level. 
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Table 2- 1. Functional List of Commands Found in this Manual. 



FUNCTION 


COMMAND 


CAPABILITIES REQUIRED 
(USER Unless Specified) 


Running Sessions 




( ) COMMAND LOGON 

ABORT 

BYE 

:EOF: 

EOD 

HELLO 

HELP 

RESUME 




Running Jobs 




COMMENT 

CONTINUE 

ELSE 

ENDIF 

EOJ 

IF 

JOB 

SET 

SETJCW 

SHOWJCW 

STREAM 




Determining Job or Session 
Status and Resources 




REPORT 

SHOWJOB 

SHOWME 


AM or SM for ACCT/SYS 

information 


Job/Session Commands 


=ABORTJOB 
= LOGOFF 
= LOGON 
=SHUTDOWN 


All may be executed only from the 
Console. 


Job/Session Commands 


: ABORTJOB* 


AM, SM, or from the Console. 


Job/Session Commands 




: ACCEPT 
: ALLOW 
: ALT JOB* 
: BREAKJOB» 
: DISALLOW 
: JOBFENCE 
: JOBSECURITY 
: LIMIT 
:LOG 
: REFUSE 
:RESUMEJOB* 


* Higher job security or AM 
capability required to execute 
command on another job session. 

All may be executed only from the 
Console, unless distributed to other 
terminals. 

OP 


Job/Session Commands 


: STARTS ESS 


PS Capability (G. 01. 00 and later) 
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Table 2-1. Functional List of Commands Found in this Manual. 



FUNCTION 


COMMAND 


CAPABILITIES REQUIRED 
(USER Unless Specified) 


Managing Files 




ALTSEC 

ALTVSET 

BUILD 

DATA 

DISMOUNT 

FILE 

LISTEQ 

LISTF 

LISTFTEMP 

LISTVS 

MOUNT 

NEWVSET 

PURGE 

PURGEVSET 

RELEASE 

RENAME 

RESET 

RESTORE 

SAVE 

SECURE 

STORE 

VSUSER 


CV 

UV or CV 

CV 

CV 

SM, OP or PM for privileged files. 
SM, OP or PM for privileged files. 


Running Subsystems and User 
Programs 

Commands marked with an 
asterisk (*) are discussed in 
detail separate subsystem 
manuals. 




BASIC* 

BASICGO* 

BASICOMP* 

BASICPREP* 

BBASIC* 

BBASICGO* 

BBASICOMP* 

BBASICPREP* 

COBOL* 

COBOLGO* 

COBOLII* 

COBOL I I GO* 
: COBOLII PREP* 
: COBOLPREP* 

DEBUG* 
: EDITOR* 
: FCOPY* 
; FORTGO* 
: FORTPREP* 
: FORTRAN* 

:FTN* (FORTRAN 77) 
: FTNGO* 
:FTNPREP* 
: PASCAL* 
: PASCALGO* 
: PASCALPREP* 
:PREP 
: PREPRUN 


PM 
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Table 2-1. Functional List of Commands Found in this Manual. 



FUNCTION 


COMMAND 


CAPABILITIES REQUIRED 

(USER Unless Specified) 


Running Subsystems and User 
Programs 

Commands marked with an 
asterisk (*) are discussed in 
detail separate subsystem 
manuals. 




: RESETDUMP* 

:RPG* 

: RPGGO* 

: RPGPREP* 

:RUN 

: SEGMENTER* 

:SETDUMP* 

:SPL* 

:SPLGO* 

:SPLPREP* 




Device and Device File Status 




: ASSOCIATE 
: CONSOLE 
: DISASSOCIATE 
: DSTAT 
: RECALL 
: SHOWALLOW 
: SHOWCACHE 
•SHOWDEV 

SHOWIN 

SHOWOUT 


AM or SM to access other accounts or 
groups. 


Device and Device File 
Commands 


=ABORTIO 


May be executed only from the 
Console. 


Device and Device File 
Commands 




ABORTIO 

ALTSPOOLFILE 

CONSOLE 

DELETESPOOLFILE 

DOWN 

DOWNLOAD 

FOREIGN 

GIVE 

HEADOFF 

HEADON 

LDISMOUNT 

LMOUNT 

OPENQ 

OUTFENCE 

RESUMESPOOL 

SHOWCOM 

SHUTQ 

STARTS POOL 

STOPS POOL 

STREAMS 

SUSPENDS POOL 

TAKE 

UP 

VMOUNT 


All may be executed only from the 
Console, unless distributed to other 
terminals. 
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Table 2-1. Functional List of Commands Found in this Manual. 



FUNCTION 


COMMAND 


CAPABILITIES REQUIRED 
(USER Unless Specified) 


Requesting Utility Operations 




FREERIN 

GETRIN 

PTAPE 

REDO 

SETCATALOG 

SETMSG 

SHOWCATALOG 

SHOWJCW 

SHOWTIME 

SPEED 

TELL 

TELLOP 




Resource Management 




ALTLOG 

CHANGELOG 

GETLOG 

LISTLOG 

RELLOG 

SHOWLOGSTATUS 


OP or LG 
OP or LG 
OP or LG 
OP or LG 
OP or LG 


Creating Private Volumes 


^VINIT 


SM or OP 


Message Commands 




REPLY/=REPLY 

WARN 

WELCOME 


May be executed only from the 
Console, unless distributed to other 
terminals. 


Program/Procedure 
Allocation 




•ALLOCATE 
:AUTOALLOCATE 
.DEALLOCATE 
:SHOWALLOCATE 


OP or SM 
OP or SM 
OP or SM 
OP or SM 


System Modification Backup 


:SYSDUMP 


OP or SM 


System Backup 


:PARTBACKUP 
rFULLBACKUP 


May be executed only from the 
Console. OP needed. 


Job and System Performance 
Management 




: CACHECONTROL 
: DISCRPS 
: JOBPRI 
: SHOWCACHE 
: STARTCACHE 
: STOPCACHE 
:TUNE 


OP or SM 

Only from the Console. 

OP or SM 

OP or SM 
OP or SM 
OP or SM 
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Table 2- 1 . Functional List of Commands Found in this Manual. 



FUNCTION 


COMMAND 


CAPABILITIES REQUIRED 
(USER Unless Specified) 


System Reports and 
Information Management 




: RESUMELOG 
.SWOWLOG 
: SHOWQ 
: SWITCH LOG 


OP or from the Console. 
OP or from the Console. 
OP or from the Console 
OP or from the Console. 


Account Management 




: ALTACCT 
ALTGROUP 
•ALTUSER 
LISTACCT 
LISTGROUP 
LISTUSER 
NEWACCT 
NEWGROUP 
NEWUSER 
PASSWORD 
PURGEACCT 
PURGEGROUP 
PURGEUSER 
REPORT 
RESETACCT 


SM 

AM 

AM 

AM or SM 

AM or SM 

AM or SM 

SM 

AM 

AM 

SM 

AM 

AM 

AM or SM 

SM 
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:( ) COMMAND LOGON 



Begins a session, executes the enclosed MPE command, and ends the session upon completion of the 
command. 



SYNTAX 



( [: ]commandname) [sessionnamem]username\Muserpass] 
.acctname[§acctpass] [§groupname[§grouppass] ] 

[WTERM=termtype] 

[§TIME=ep«sees] 

<BS> 
fil <CS>, 

<ES> 



r {|INPRI =in put priority}, 
1 {;HIPRI } J 



PARAMETERS 

cortma.ndna.me 

sessionname 



username 



userpass 



acctname 



acctpass 



Any MPE or user defined command (UDC), including its parameter list. 
The prompting colon may be omitted. 

Arbitrary name used in conjunction with username and acctname to form a 
fully qualified session identity. This name must contain from one to eight 
alphanumeric characters, beginning with an alphabetic character. Default 
is that no session name is assigned. 

Username, established by the Account Manager, that allows you to logon 
under this account. The name must contain from one to eight 
alphanumeric characters, beginning with an alphabetic character. 

User password, optionally assigned by the Account Manager. This password 
must contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. A slash (/) must precede the userpass parameter. 

Account name as established by the System Manager. This name must 
contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. A period ( .) must precede the acctname parameter. 

Account password, optionally assigned by the Account Manager. This 
password must contain from one to eight alphanumeric characters, 
beginning with an alphabetic character. A slash must precede the acctpass 
parameter. 
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groupname 



Group name to be used for the local file domain and the CPU time charges, 
as established by the Account Manager, containing from one to eight 
alphanumeric characters, beginning with an alphabetic character. Default 
is your home group, if one is assigned. The parameter is required if a home 
group is not assigned. 



grouppass 



Group password, optionally assigned by the Account Manager. This 
password must contain from one to eight alphanumeric characters, 
beginning with an alphabetic character. You do not need to enter the 
grouppass parameter when you logon to your home group. If, you request 
a logon group that is assigned a password, you must supply the password 
when you logon to that group. A slash (/) must precede the grouppass 
parameter. 



termtype 



Determines terminal-type characteristics. The value assigned to the 
termtype parameter determines the type of terminal used for input and its 
characteristics. The default value for termtype, a number from to 22, is 
assigned by the System Supervisor during system configuration. If your 
terminal is not of the default termtype, you must supply this parameter to 
ensure correct terminal input and output. For more information, refer to 
Appendix A "TERMINALS SUPPORTED BY MPE". 



cpusecs 



BS, CS, DS, or ES 



The termtype parameter is the name of the file containing the desired 
terminal -type characteristics. The file may not have a lock word or reside 
on a Private Volume. 

Users of the Workstation Configurator are allowed to create terminal -type 
files. The proper and efficient operation of a specific device by a user 
created terminal-type is the responsibility of the user. The Workstation 
Configurator utility allows the user to specify the following characteristics 
of the terminal: data flow control, block mode, read trigger, special 
characteristics, echo, line feed, parity, and printer control. 

If group and/or account names are omitted, the logon group and/or account 
name is substituted. For further information on the terminal-type 
characteristics, refer to the Fundamental Communications Handbook 
(5957-4634) and the Workstation Configurator Reference Manual 
(30239-90001). Refer also to Appendix A, "TERMINALS SUPPORTED 
BY MPE", in Section III of the manual. 

The maximum CPU time that your session can use, entered in seconds. 
When this limit is reached, session is aborted. It may be any value from 1 
to 32767, provided that it does not limit imposed by the System or Account 
Manager. To specify no limit, specify question mark (?) or UNLIM, or 
omit this parameter. Default is no limit. 

The execution priority queue that the Command Interpreter uses for your 
session. It is also the default priority for all programs executed within the 
session. BS is highest priority, ES is lowest. If you specify a priority that 
exceeds the highest permitted by the system, for your account or username 
by the system, MPE assigns the highest priority possible below BS. DS and 
ES are intended primarily for batch jobs. Using them for sessions may 
produce less than optimum performance, sessions is generally discouraged. 
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CAUTION 



Use care in assigning the BS queue, because processes in 
this priority class may lock out other processes (MPE uses 
the BS queue). 



For information on the guidelines for use of these priority queues, refer to 
the :TUNE command in the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). Default is CS. 

inputpriority or Determines the input priority of the job or session. It may be a value from 

HI PRI 1 (lowest priority) to 1 3 (highest priority). The default is 8. If you supply a 

value less than or equal to the current job fence as set by the Operator, or 
the job fence is equal to or greater than the default inputpriority, the 
session will be denied access. 

The ; HI PRI option has two purposes: to override the system job fence, or to 
override the session limit. When using the ; HI PRI option to override the 
job fence, the system will first check to see whether you have either System 
Manager (SM) or System Supervisor (OP) capability. If you have one or the 
other, you will be logged on, and your ;INPRI will default to the system's 
job fence and execution limit. If you do not have either capability, you will 
receive the following warning: 

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HI PRI, 
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460) 

Despite this warning, the system will still allow you to logon if your default 
input priority (8) exceeds the job fence. If the job fence exceeds your input 
priority, you will not be able to logon unless you have SM or OP capability. 



USE 

This command may not be used from a Session or Job. It is not available from BREAK, or a Program It 
is not Breakable. 

Pressing (BREAK) during the output of the logon message terminates the rest of the message and 
causes the immediate execution of the command within the parentheses. Pressing (BREAK) during 
the execution of the command within the parentheses interrupts the execution, if the command is 
breakable. If there is an option logon UDC that is not a program, the UDC is not breakable and 
execution is forced at logon time. 
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OPERATION 

This command initiates a session and immediately executes the command contained within the 
parentheses. Once the command or subsystem specified inside the parentheses is executing, all input, 
output, BREAK capabilities, and prompts operate as described in the command or subsystem instructions. 
After the execution of the command or subsystem is completed, normally or through an abort, a logoff is 
performed automatically. 

Note that this command has the following limitations: 

• You must enter the : ( ) COMMAND LOGON at a terminal. No other device can be used for this 
command. 

• Unlike the : HELLO command, : ( ) COMMAND LOGON is not recognized within sessions. 

• Use of commands which would normally cause an end-of-file, such as : HELLO, : BYE, :JOB, :DATA, 
: EOD, : : EOF : , and : EOJ, will cause the session to terminate as soon as as they are encountered by the 
MFE Command Interpreter. 

• Only one MPE command is allowed within the parentheses. Leading and trailing blanks are 
suppressed within the parentheses. 

If you omit any passwords required in the : ( ) COMMAND LOGON, MPE prompts you for them 
individually. 

When MPE initiates the session, it displays "HP 3000", the user defined and official (base) version. update, fix 
number (an HP method of distinguishing between software releases), the date, and the time as follows: 

HP3000 / MPE V G.02.B0 (BASE G.02.B0). MON, AUG 11, 1986, 8:22 AM 

After the logon message is printed at your terminal, MPE executes the command specified within the 
parentheses. The information MPE generates as a result of this command is transmitted to your terminal 
immediately; just as if you had called that command or subsystem during a session. When the command 
or subsystem is exited, MPE terminates the session at once, and displays the central processor (CPU) time 
used (in seconds), the connect time (in minutes), and the date and time, as follows: 

CPU=1. CONNECTS. MON, AUG 11, 1986, 8:22 AM 

EXAMPLE 

To logon under username MAC, acctname TECHPUB, and groupname XGROUP, and execute the :LISTF 
command, enter: 

: (LISTF) MAC. TECH PUB, XGROUP 

HP3000 / MPE V G.02.B0 (BASE G.02.B0). MON, AUG 11, 1986, 8:22 AM 

FILENAME 

FIRST GP005 TRIAL XPROG 

CPU=1. CONNECTS. MON, AUG 11, 1986, 8:22 AM 
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ABORT 



Aborts the current program or operation. 

SYNTAX 



: ABORT 



PARAMETERS 

None. 

USE 

This command may be issued from a Session (in BREAK only). It is not executable from a Job, or a 
program. It is not Breakable. 

OPERATION 

After you suspend a program or MPE command operation by pressing [BREAK] , the : ABORT command 
terminates that program or operation. Programs do not terminate while critical system code is executing 
on their behalf, but will terminate immediately following execution of that code. The : ABORT command 
is available only from a session and only during a BREAK, but it does not disrupt the session. Some 
operations abort immediately upon entering BREAK without requiring the : ABORT command. An 
: ABORT command results in the Job Control Word (JCW) being set to the "SYSTEM 0" state. For a 
discussion of Job Control Words, refer to the : SETJCW command in this section. 

EXAMPLE 

To abort the current operation, enter: 
: ABORT 
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:ABORTIO/=ABORTIO 

Aborts one pending I/O request for a device. 

SYNTAX 



:ABORTIO Idei) 



PARAMETERS 

Idea The logical device number of the device for which I/O is being aborted. 



USE 

This command may be issued from a Session, or Job. It is available from within BREAK, or a program. It 
is not breakable. /=ABORTIO is executable only from the Console. 

* Unless distributed to users with the : ALLOW or : ASSOCIATE command. 

OPERATION 

This command aborts all pending I/O operations on the specified Idev. To delete all queued I/O requests 
for a device, repeat the :ABORTIO command until the following message is printed on the $STDLIST 
device: 

NO I/O TO ABORT FOR DEVICE HdeO 

Those devices which are : JOB or : DATA accepting always have outstanding read requests pending, due to 
the auto-recognition feature of MPE. The rABORTIO command is used to clear these pending input 
requests. 

To completely clear spooled devices, several :ABORTIO commands may be necessary. Issue the rABORTIO 
command until there are no queued I/O requests, and the message above appears on the $STDLIST device. 

Clearing all outstanding I/O requests is sometimes required in order to allow proper execution of other 
Console commands. In certain cases the : ABORT JOB , :TAKE , :DOWN , and : REFUSE commands will not 
execute unless an : ABORTIO command is first issued to clear pending I/O operations on the appropriate 
device. 



NOTE 



If .-ABORTIO is not effective from the System Console, 
=ABORTIO may be used. The =ABORTI0 command should be 
used only when the rABORTIO command cannot be executed, 
or when the Console is busy. 
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EXAMPLES 

To abort all pending I/O requests for logical device 53 , enter: 

: ABORTIO 53 

11:16/3/N0 I/O TO ABORT FOR DEVICE 53 

It is necessary to issue several : ABORT 10 commands to abort all pending I/O operations on a spooled 
device, as shown below: 

; ST0PSP00L 5 

1 1 : 20/31 /SP#5/ST0PPED 

1 1:20/3 1/LDEV#5 NOT READY 

: REFUSE 5 

: AB0RTI0 5 

: ABORTI0 5 

11.21/40/N0 I/O TO ABORT FOR DEVICE 5 
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:ABORTJOB/=ABORTJOB 



Aborts a job or session. 

SYNTAX 



{#Jnnn } 

: ABORT JOB {iSnnn } 

{ [jobname% ] user*acct } 



PARAMETERS 

§Jnnn 

§Snnn 

jobname 

user 

acct 



A job number. 

A session number. 

The name of the job, as identified by the : SHOWJOB command. 

A username. 

An account name. 



USE 

This command may be issued from a Session, Job, Program or in BREAK. It is not Breakable . It is 
executable only from the Console*, or by a user with Account Manager (AM) or System Supervisor (SM) 
capabilities. The : ABORTJOB command may be issued only from the Console. 

* Unless distributed to users with the : ALLOW command, or with : JOBSECURITY set LOW. 

OPERATION 

This command terminates the designated job or session, and displays the following message on the 
job/session list device: 

SESSION ABORTED BY SYSTEM MANAGEMENT 

If you use the " [jobname t ]user. acct" form of the command when there is more than one job or session 
executing under that name, MPE will randomly select which job/session to abort. Therefore, to exercise 
the more precise control when aborting jobs or sessions, use the #Jnnn or #S«nn form of the : ABORTJOB 
command. Although the job/session is abnormally terminated, log records are issued, and CPU and 
connect times are updated. Any I/O activity (i.e. printing, : STORE , etc) will also be terminated. 

The : ABORTJOB command can be applied to waiting and scheduled jobs, as well as to executing jobs. If 
the spooler input file ($STDIN) for a batch job has been created and not yet opened (i.e. the job is in the 
WAIT state), the entire file will be deleted. If the : ABORTJOB command is issued before the output 
spoolfile is complete, only that portion of the file already spooled will be printed, along with an error 
message indicating that the job was aborted. 
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If a request is pending at the System Console, it will be terminated automatically by the 
: ABORT JOB/=ABORT JOB command. The following message will appear on the system console: 

Hme/#SM«w/pt«/REQUEST REQUIRING OPERATOR REPLY FOR PIN #«» HAS BEEN ABORTED 

When the : ABORT JOB command is successful, a logoff message is displayed, indicating that the job being 
executed has been aborted, as shown in the example below: 

; ABORTJOB »S9 
11:20/#S9/34/L0GOFF ON LDEV #77 

Two messages will also be displayed on the user's terminal: the standard error message that appears when 
a request is manually terminated by a =REPLY of or N and: 

SESSION ABORTED BY SYSTEM MANAGEMENT 

The ^ABORTJOB command may be used at the Console if : ABORTJOB is ineffective. Refer to the "USE" 
section of this command, busy. 

EXAMPLES 

To terminate session number 1 39 , enter: 

; ABORTJOB #S139 
17:10/#S139/34/LOGOFF ON LDEV #62 

To terminate job number 9 , enter: 

: ABORTJOB #J9 
20:18/#J9/26/LOGOFF ON LDEV #10 

Note that in both cases, the execution was successful, and a logoff message was printed. 

To terminate session 6 , which has a pending device allocation message, enter: 

?17:00/#S6/23/LDEV# FOR "SCRTAPE" ON TAPE (NUM)? 

: ABORTJOB #S6 

17: 10/#S6/120/REQUEST REQUIRING OPERATOR REPLY FOR PIN 23 

HAS BEEN ABORTED 
17:10/#S6/120/LOGOFF ON LDEV #58 
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:ACCEPT 



Permits a designated device to accept jobs/sessions and/or data. 

SYNTAX 



: ACCEPT \^S.ldeO 
[ DAT Alii; J 



PARAMETERS 

JOBS Specifies that the designated device will recognize the : JOB and : HELLO 

commands. The device must be interactive to support sessions. 

DATA Specifies that the designated device will recognize :DATA commands. 

designated device. 

Idea The logical device number of the device for which the :JOB, : HELLO, 

and/or : DATA commands are being enabled. 



NOTE 



If both the JOBS and the DATA parameters are omitted, then 
both the :JOB and : HELLO commands, and the :DATA 
command are allowed. 



USE 



This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is 
executable only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

The Operator or System Supervisor uses this command to designate which devices may be used to initiate 
jobs or sessions and/or data. When a device is configured as an "accepting" device, MPE will 
automatically scan the first input record for a valid :JOB, : HELLO, or :DATA command. This feature, 
called "auto -recognition", allows users to access the device without specifically requesting use of the device 
with a message to the system console. 

If the JOBS parameter is explicitly requested, the : ACCEPT command will not be executed unless the 
device has been configured with a default output device. Refer to "RECONFIGURING THE SYSTEM" in 
the MPE V System Operation and Resource Management Reference Manual (32002-90005). 
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EXAMPLES 

To permit logical device 1 9 to accept jobs and data, enter: 

: ACCEPT 19 

; SHOWDEV 19 

LDEV AVAIL OWNERSHIP VOLID ASSOCIATION 

19 A AVAIL 
To permit logical device 1 9 to accept jobs and data, and to allow the device to be spooled, enter. 

: ACCEPT 19 
; STARTSPOOL 19 
11:12/31/SP#/S POOLED IN 
11:12/6/LDEV#19 NOT READY 
: SHOWDEV 19 
DEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION 

19 SPOOLED SPOOLER OUT 
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:ALLOCATE 



Permanently loads a program or procedure into main memory. 

SYNTAX 



.,,„._. [procedure!] 

ALLOCATE | pR0GRAM| *j name 



PARAMETERS 

PROCEDURE 

PROGRAM 

name 



Specifies that the procedure in SL. PUB. SYS indicated by name is to be 
allocated. The default is PROGRAM . 

Specifies that the program file indicated by name is to be allocated. 
Default. 

The name of the program file or procedure to be allocated. 



USE 

This command may be issued from a Session or Job. It may not be issued from a Program, or in BREAK, 
and is not Breakable. A user must have System Supervisor (OP) capability to use this command. 

OPERATION 

A program or procedure is allocated by resolving external references and assigning Code Segment Table 
(CST) or Extended Code Segment Table (XCST) entries to the program's code segments. Table entries are 
also allocated for any procedures called by the allocated program or procedure. Allocating a program or 
procedure will not increase execution speed. However, it will reduce the time taken to load the program 
for execution. 



CAUTION 



Use care in deciding which programs or procedures to load 
with : ALLOCATE. The number of CST table entries is 
limited. Exceeding the limit runs the risk of losing data. 



Segments remain loaded until they are deallocated with the : DEALLOCATE command, or until the system 
is shut down or a system failure occurs. Programs or procedures must be reallocated with the : ALLOCATE 
command following any start up. 

The user issuing the : ALLOCATE command must have EXECUTE access for any file referenced in the 
name parameter of this command. 

Any external procedures referenced by a program being allocated by this command must reside in 
SL. PUB. SYS. 
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EXAMPLE 

To allocate a procedure identified as PR0C1 , that resides in SL . PUB. SYS , enter: 
; ALLOCATE PROCEDURE, PROC1 



NOTE 



Program files residing in the non -system domain (a private 
volume) will not be allocated. Attempts to do so will result 
in a "LOAD ERR 92 " message. 

ADDITIONAL DISCUSSION 

Refer to the discussion of Program Allocation in "CHANGING OTHER SYSTEM PARAMETERS" in the 
MPE V System Operation and Resource Management Reference Manual (32033-90005). 
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:ALLOW 



Grants a user access to a specific Operator command. 

SYNTAX 



: ALLOW FlLE=formaldesignator[§SHOH] 



:ALLOW /g SSr 'f JlCOMMAMDS*coiiina«d[|e«iii«nd, . . . ] 
{user.acot} 



PARAMETERS 

formaldesignator 

SHOW 
1.6 

user .6 
Q.acct 
user.acot 
command 



A formal ASCII filename, which may consist of one to eight 
alphanumeric characters, beginning with an alphabetic character. 

Lists input lines on $STDLIST. 

Grants access to all users whether logged on or not. 

Grants access to a specific user in all accounts. 

Grants access to all users in a specific account. 

Grants access to a specific user in a specific account. 

Specifies the names of those commands to which the user is granted 
access. 



USE 

This command can be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is 
executable only from the Console. * 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

The Operator uses the : ALLOW command to distribute specific Operator commands to system users. You 
indicate at the console which users may execute Operator command(s), then the names of each command 
they will be allowed to execute. 
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This command may also be executed in indirect and subsystem modes. You must create a file that 
contains records identifying the user(s) and account(s) to whom you are allowing Operator commands, 
followed by the list of commands allowed, such as: 

; EDITOR 

HP32201A.7.16 EDIT/3000 TUES, MAY 29, 1985, 5:08 PM 

(C) HEWLETT-PACKARD CO. 1984 

/ ADD 

1 SUSAN. PAYROLL ;COMMANDS=ALT JOB, ALTSPOOLFILE 

2 JOHN . ACCTNG;COMMANDS=ALTSPOOLFI LE , DELETESPOOLFI LE 

3 LL 

/ KEEP ALLOWTMP 
/E 

Then issue the : ALLOW command, using the the ;SHOW parameter to display each command line as it is 
executed from the file. 

; ALLOW FILE=ALLOWTMP;SHOW 

In subsystem mode, enter " : ALLOW ", followed by [RETURNI . You will be prompted with a "> ". Command 
parameters are accepted until an end-of-file is received, or until you EXIT. 

The Operator may : ALLOW console capabilities only to users who are currently logged on to the system, 
unless the @.@ option of the : ALLOW command is used. In this case, all users are affected, whether or not 
they are logged on. Additional capabilities granted to a user last only for the duration of their current 
session: once the user logs off, any special capabilities previously assigned are no longer applicable. 

The user command :SHOWALLOW indicates which Operator commands have been allowed globally and to 
that specific user. Refer to : SHOWALLOW in this section. 

EXAMPLES 

To give the user MAC . TECH the ability to execute the : REPLY and : ABORTIO commands, you would enter 
the following on the system console: 

: ALLOW MAC. TECH ;COMMANDS=REPLY, ABORTIO 

In subsystem mode, to give the user MGR. MANUALS the ability to execute the BREAKJOB command, you 
would enter the following on the system console: 

; ALLOW 

> MGR . MANUALS ;COMMANDS=BREAKJOB 

>EXIT 
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:ALTACCT 

Changes the attributes of an existing account. 

SYNTAX 



:ALTACCT acctname 
[|PASS= [password] ] 
t|FILES= [filespace] ] 
[|CPU=[ep«]] 
[||CONNECT= [connect]] 
[iCbP=[capabilitylist] ] 
t|ACCESS= [ (fileaccess) ] ] 
[|MAXPRI= [subqueuename] ] 
[|LOCATTR= [localattribute] ] 
m^olset:]^] 

[|USERPASS=[[j^>]] (1) 



PARAMETERS 

acctname The name of the account to be altered. 

password Account password (used only for verifying logon access). If this parameter 

is omitt ed, no change is made. If the System Manager enters ";PASS = 
[RETURN] ", then the existing password is removed. 

filespace Disc storage limit, in sectors, for the permanent files in the account. The 

filespace limit cannot be less than the the number of sectors currently in 
use for the account. Default is unlimited file space. 

opu The limit on cumulative CPU time, in seconds, for the account. This limit 

is checked only when a job or session is initiated, and therefore never causes 
the job or session to abort. The maximum value allowed is 2, 147,483,647 
seconds. Default is unlimited CPU time. The counter may be set to zero 
with the : RESETACCT command. 

I ( 1 ) The USERPASS parameter is only available if HP Security Monitor (HP 30 392) has been installed. 
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connect The limit on total cumulative job or session connect time, in minutes, 

allowed the account. This limit is checked at logon and every time a 
process terminates. The maximum value allowed is 2,147,483,647 
minutes. Default is unlimited connect time. The counter may be set to 
zero with the : RESETACCT command. 

capabilitylist List of capabilities, separated by commas, permitted the account. Each 

capability is denoted by a two-letter mnemonic, as follows. 



System Manager = 


SM 


Account Manager = 


AM 


Account Librarian = 


AL 


Group Librarian 


GL 


Diagnostician = 


DI 


System Supervisor = 


OP 


Network Administrator = 


NA 


Node Manager = 


NM 


Permanent Files = 


SF 


Access of nonsharable 




I/O devices = 


ND 


Use Volumes = 


UV 


Create Volumes 


CV 


Use Communications 




Subsystem = 


CS 


Programmatic Sessions = 


PS 


User Logging = 


LG 


Process Handling 


PH 


Extra Data Segments = 


DS 


Multiple RINs 


MR 


Privileged Mode = 


PM 


Interactive Access = 


IA 


Local Batch Access = 


BA 



Default is "AM,AL,GL,SF,ND,IA,BA " , except for the SYS account. This 
account has no true default: it is assigned the maximum account capabilities 
when the system is delivered and, under normal circumstances, should not be 
altered. Note that CV capability, which permits account members to create 
Private Volumes, automatically gives the account UV capability, allowing 
account members to use Private Volumes. 

fileaccess The restrictions on file access pertinent to this account. Default is 

R , A , L , W , X : AC, entered as follows: 

{R} 

([<A)[,...]:iJ!! Y l ][;...]) 

{W} {RL ' 
{X} 
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where R , L , A , W , and/or X specify modes of access by types of users (ANY 
and/or AC ) as follows: 

R = Read 

L = Lock (allows exclusive access to file) 

A = Append (implicitly specifies L also) 

W = Write (implicitly specifies A and L also) 

X = Execute 

The user types are specified as follows. 

ANY = Any user 

AC = Member of this account only 



subqueuename 



Name of the highest priority subqueue that can be requested by any process 
of any job/session in the account, specified as AS, BS, CS, DS, or ES. Default 
is CS. 



CAUTION 



User processes executing in the AS or BS subqueues can 
deadlock the system. If you assign these subqueues to 
non-priority processes, other critical system processes may be 
prevented from executing. Exercise extreme caution when 
choosing subqueues. 



localattribute 



oolset 



SPAN 



ALT 



REQ 



Local attribute of the account, as defined at the installation site. This is a 
double word bit map, of arbitrary meaning, that might be used to further 
classify accounts. While it is not involved in standard MPE security 
provisions, it is available to processes through the WHO intrinsic. 
Programmers may use localattribute in their own programs to provide 
security. Default is double word (null). 

The volume set or class reference which, when fully qualified, is in the 
form vcsid. groupname.acctname where vcsid refers to a previously defined 
volume set or class definition. 

Indicates that the acctname is to be inserted in the accounting directory of 
the specified volume set (volset). The specified volume set must have been 
previously mounted (via a : MOUNT command) for the SPAN operation to 

succeed. 

Directs the altering of an account or group entry on the specified volume 
set. This option is useful only if it is necessary to alter account and group 
file space limits for entries that have already been spanned. 

USERPASS=REQ specifies that all users in the account must have a 
non-blank password. It is available only if HP Security Monitor (HP30392) 
has been installed. Refer to the HP Security Monitor Users Guide for more 
information. 
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OPT 



USERPASS=OPT specifies that users in this account may or may not have 
passwords. If you do not use the USER PASS parameter, t> e old value 
remains. It is available only if HP Security Monitor (HP30392) has been 
installed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have System Manager (SM) capability to use this command. 

OPERATION 

The System Manager uses :ALTACCT to change the attributes of an existing account. Multiple keywords 
may be entered on a single command line as shown in "EXAMPLE". When you change one capability in a 
capabilitylist containing several nondefault values, you must respecify the entire new capabilitylist. When 
an entire keyword parameter group is omitted from the :ALTACCT command, that parameter remains 
unchanged for the account. When a keyword is included, but the corresponding parameter is omitted (as 
in " ; PASS= "), the default value is assigned. 

The USERPASS= parameter must be used in conjunction with REQ or OPT. The old value will remain in 
effect if the USER PASS parameter is omitted. This is only valid if you have installed the HP Security 
Monitor. 



PARAMETER 


DEFAULT VALUES 


password 


No password 


filespace 


Unlimited 


cpu 


Unlimited 


connect 


Unlimited 


capabilitylist 


AM,AL,GL,SF,ND,IA,BA (All accounts except SYS) 




SM,AM,AL,GL,DI,OP,SF,ND,PH,DS,MR,PM,IA,BA(SYS ac- 




count only) 


fileaccess 


( R , A , W , L , X : AC) (All accounts except SYS ) 




(R,X:ANY;A,W,L:AC) (SYS account only) 


subqueuename 


CS subqueue 


localattribute 


Double word (null) 



Any value changed with : ALTACCT will take effect the next time MPE is requested to check the value. 
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I 



If an attribute is removed from an account while users are logged on, they will not be affected until they 
end the job or session and logon again. 

MPE does not automatically generate a message informing users of the change; it is your responsibility to 
warn account members in advance of any changes. If you take a capability away from an account, all ac- 
count members and groups within the account also lose the capability. 

You cannot remove System Manager (SM) capability from the SYS account. You also cannot take AM 
capability away from any account. If more than one person is assigned AM capability within the account, 
you can remove AM capability from all but one (the last) user assigned it. 

EXAMPLE 

To change an account AC2 so that its password is GLOBALX, and it filespace is limited to 50,000 sectors, 
enter: 

; ALTACCT AC2 ; PASS=GLOBALX ; FI LE=50000 

ADDITIONAL DISCUSSION 

HP Security Monitor Users Guide (30392-90001) 
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rALTGROUP 



Changes one or more attributes of a group. 

SYNTAX 



;ALTGROUP groupname[. account name] 
[|PASS= [password] ] 
[iChP= [capabilit ylist] ] 
[|FILES= [filespace] ] 
[;|cpu=[cpw]] 

[||CONNECT= [connect]] 
[|ACCESS=[ (fileaccess) ] ] 



im=[oolset:^J i ][;...]] 



PARAMETERS 

groupname 
account name 

password 



capabilit ylist 



Specifies the name of the group whose attributes are to be changed. 

As System Manager you can include the account name when logged onto an 
account other than the requested account. 

The new password to be assigned to the group (used to verify logon access 
only). If this parameter is omitted, no change is made. If the Operator 
enters " ; PASS = [RETURN] " then the existing password is removed. The 
password must consist of one to eight alphanumeric characters, beginning 
with an alphabetic character. 

Specifies the list of capabilities permitted this group. Each capability is 
denoted by a two -letter mnemonic, as follows. 



Process Handling 


= PH 


Extra Data Segments 


= DS 


Multiple RINs 


= MR 


Privileged Mode 


= PM 


Interactive Access 


= IA 


Local Batch Access 


= BA 



Two or more capabilities may be specified if they are separated by commas. 

Default is IA,BA except for the PUB group of the SYS account. This group 
has no true default. It is assigned the maximum group capabilities when 
the system is delivered and should not normally be changed. 
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file space 



cpu 



Disc storage limit, in sectors, for the permanent files of the group. A 
group's filespace cannot be set to a value greater than the corresponding 
limits currently defined for the group's account. If an account's filespace is 
later changed, the group limits are automatically changed. Default is un- 
limited file space. 

The limit on the total cumulative CPU time, in seconds, for the group. This 
limit is checked only when a job or session is initiated; the limit never 
causes a job/session to abort. The maximum value you may specify with 
this command is 2,147,483,647 seconds. If the limit is exceeded, users 
with Account Manager capability will be warned when logging on; other 
users will be denied access. 



The CPU limit for a group cannot set to a value greater than the cor- 
responding limit currently defined for the account in which that group 
resides. If the CPU limit for an account is changed later, group limits are 
automatically changed. Default is unlimited CPU time. The counter may 
be set to zero with the : RESET ACCT command. 



connect 



The limit on the total cumulative job or session connect time, in minutes, 
that the group is allowed. This limit is checked at logon, and whenever the 
job or session initiates a new process. The maximum value you may specify 
with this command is 2,147,483,647 minutes. If the limit is exceeded, 
users with Account Manager capability will be warned when logging on; 
other users will be denied access. 



fileaccess 



A group's connect limit cannot be specified as greater than the correspond- 
ing limit currently defined for the account in which the group resides. 
However, if the connect limit of the account is changed later, its groups' 
limits will automatically be changed. Default is unlimited connect time. 
The counter may be set to zero with the : RESET ACCT command. 

The restriction on file access pertinent to this group. Default is 
R,X:ANY;A,W,L,S:AL,GU for the Public Group (PUB); and 
R , A , W , L , X , S : GU for all other groups, entered as follows: 



<R} 
{L} 

{A} IS. 
<W} 
{X} 



{ANY} 
{AC > 

]| {gu Hi...] 

{AL } 
{GL ) 



where R , L , A , W , and X specify modes of access by types of users (ANY 
AC , GU , AL , GL ) as follows: 



R 
L 
A 
W 
X 
S 



= Read 



Lock (allows exclusive access to the file) 
Append (implicitly specifies L also) 
Write (implicitly specifies A and L also) 
Execute 
Save 
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The user types are specified as follows: 

ANY = Any user 

AC = Member of this account only 

GU = Member of this group only 

AL = Account librarian user only 

GL = Group librarian user only 

Two or more user or access types may be specified if they are separated by 
commas. 

Volset A volume set or class reference which, when fully qualified, is in the fol- 

lowing format: 

Ocsid . groupname . acctname 

where vcsid refers to a previously defined volume set or class definition. 

If volset is different from the old volume set, and the old volume set is the 
system set, then the old volume set must be examined for the presence of 
files belonging to groupname. If no such files are found, the command will 
succeed, and the group is reassigned to volset as its new home volume set. 

If volset is omitted from the VS= parameter, the group will be reassigned to 
the system volume set. If the old volume set is already the system volume 
set, nothing will be altered. 

It is permissible to reassign a group to a different volume set despite the 
presence of files belonging to groupname, as long as the old volume set is 
not the system volume set and the groupname is not currently bound to its 
home volume set, either explicitly via the : MOUNT command, or implicitly, 
via the FOPEN intrinsic. 

SPAN Indicates that the groupname is to be inserted in the accounting directory 

of the specified volume set (volset). The specified volume set must have 
been previously mounted, via the : MOUNT command, for the SPAN operation 
to succeed. 

ALT Directs the altering of an account or group entry on the specified volume 

set. The ALT option is required to alter account and group file space limits 
for entries that have already been spanned. This option is also required for 
changing security specifications on a volume set. 
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USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user must 
have Account Manager (AM) capability to use this command. 

OPERATION 

This command changes one or more attributes of a group; multiple parameters may be specified on a single 
command line as shown in "EXAMPLE". When you omit an entire parameter from an : ALTGROUP com- 
mand, the corresponding value for the group remains unchanged. When you include a keyword but omit 
the corresponding parameter (as in " ; PASS-'), the default value is assigned as follows: 



PARAMETERS 


DEFAULT VALUES 


password 


Null (No password) 


capabilitylist 


IA,BA (except PUB. SYS ) 
PH,DS,MR,PM,IA,BA (PUB. SYS only) 


files pace 


Unlimited 


cpu 


Unlimited 


connect 


Unlimited 


fileaccess 


R,A,W,L,X,S:GU (All groups except PUB ) 
R,X:ANY;A,W,L,S:AL,G,U (PUB group only) 



When a parameter is modified through the : ALTGROUP command, it immediately takes effect in the direc- 
tory. It does not affect any active users with open files in the group, until they terminate their session and 
logon to that username and group again. For this reason, it is a good idea to notify all group users of any 
planned changes in advance. 



EXAMPLE 

To assign a new password, PASS2 , to a group named GROUPX , enter: 
: ALTGROUP GROUPX; PASS=PASS2 
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:ALTJOB 



Alters the attributes of waiting or scheduled jobs. 

SYNTAX 



; ALT JOB 



{#Jnnn) 
{#S/?m?> 



[; l\i?Rl=input priority] 

[;OUTDEV= { "?\ >] 
•* {deoclass} 1 



PARAMETERS 

fJnnn 
#Snnn 

input priority 
IdeO or devclass 



A job number. 

A session number. (Although syntactically correct, this parameter is 
rarely used; sessions do not wait.) 

Specifies the new input priority (0 = lowest; 1 4 = highest). 

Specifies the logical device number or device class name of the 
destination device job's $STDLIST. 



USE 

This command may be issued from a Session, Job, Program or in BREAK. It is not Breakable. Users may 
execute :ALTJ0B to change their own jobs. To change other users' jobs, the command must be issued from 
the Console.* 

* Unless distributed to users with the : ALLOW command, or if : JOBSECURITY is set LOW. 

OPERATION 

The : ALT JOB command, in conjunction with the : JOBFENCE command, allows you to control the flow of 
all jobs on the system with the exception of HI PR I jobs. It can be used to alter only jobs in the INTRO 
and WAIT, or SCHED state. Jobs with input priority less than or equal to the current JOBFENCE, a 
numerical value from to 14, will be deferred. 
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EXAMPLE 

Consider three jobs that are submitted by a user and suppose that all of these jobs have an IN PR I value of 
8. To change their IN PR I values to ensure that J0B1 runs first, J0B2 runs last, and J0B3 runs second 
with LP allocated as the OUTDEV for J0B3 , enter the following commands: 



: JOBFENCE 14 

15:11/#J1/24/DEFERRED JOB INTRODUCED ON LDEV #53 

15:11/#J2/25/DEFERRED JOB INTRODUCED ON LDEV #53 

15:13/#J3/26/DEFERRED JOB INTRODUCED ON LDEV #53 



"Prevents all jobs 
**from running while 
**the user changes 
**the IN PR I values 



** 
** 



SHOWJOB 














JOBNUM 


STATE 


IPRI 


JIN 


J LI ST 


INTRODUCED 


JOB NAME 


#S23 


EXEC 




20 


20 


THU 2:15P 


OPERATOR. SYS 


#J1 


WAIT 


D 8 


10S 


12 


THU 3:11P 


JOB2, OPERATOR. SYS 


#J2 


WAIT 


D 8 


10S 


12 


THU 3:1 IP 


JOB3, SARAH. PAYROLL 


#J3 


WAIT 


D 8 


10S 


12 


THU 3:13P 


JOB1.JOHN.ACCTNG 



4 JOBS: 

INTRO 

3 WAIT; INCL 3 DEFERRED 

1 EXEC; INCL 1 SESSIONS 
SUSP 

JOBFENCE= 14; JLIMIT= 5; SLIMIT= 16 



ALTJOB #J1 ;INPRI=10 



ALTJOB #J3;INPRI=9;OUTDEV=LP 



ALTJOB #J2;INPRI=8 



JOBFENCE 6 



16:21/#J7/34/LOG0N FOR: 
16:21 /#J8/35/LOGON FOR: 
.•SHOWJOB 



JOB1, FIELD. SUPPORT ON LDEV #10 
JOB2, FIELD. SUPPORT ON LDEV #10 



JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 



#S23 


EXEC 




20 


20 


THU 


2:15P 


#J1 


WAIT 


D10 


10S 


12 


THU 


3: 1 1 P 


#J3 


WAIT 


D 9 


10S 


LP 


THU 


3:13P 


#J2 


WAIT 


D 8 


10S 


12 


THU 


3:11P 



OPERATOR. SYS 
JOB2, OPERATOR. SYS 
JOB1.JOHN.ACCTNG 
J0B3, SARAH. PAYROLL 



4 JOBS: 

INTRO 

3 WAIT; INCL 3 DEFERRED 

1 EXEC; INCL 1 SESSIONS 
SUSP 

JOBFENCE= 6; JLIMIT= 5; SLIMIT=16 



♦♦Resetting the jobfence at 6 ** 
♦♦permits all jobs with IN PR I ♦♦ 
♦♦values of 7 or above to run ♦♦ 
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:ALTLOG 



Alters the attributes of an existing user logging identifier. 



SYNTAX 



:ALTLOG logid 

{pISC } 

{^CTAPE} 

[|PASS=pass«itorrf] 

^lAUTO }j 
{pOAUTO} 



PARAMETERS 

logid 
log file 

password 

AUTO 
NOAUTO 



The logging identifier whose attributes are to be changed. This identifier 
must contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. 

The name of the file to receive data from the logging procedure. This 
name must contain from one to eight alphanumeric characters, beginning 
with an alphabetic character. You must specify the device class on which 
logfile resides, i.e. DISC, TAPE, SDISC, or CTAPE. 

The new password for the logging identifier. This password must contain 
from one to eight alphanumeric characters, beginning with an alphabetic 
character. 

Initiates an automatic CHANGE LOG if the current logfile becomes full. 
Refer to : CHANGE LOG in this section. 

Prevents the initiation of an automatic CHANGE LOG. A CHANGELOG will not 
be performed if the current logfile becomes full. Default. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It requires 
System Supervisor (OP) or User Logging (LG) capability. 
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OPERATION 

This command changes the attributes of an existing user logging identifier to those specified in the param- 
eter list. Parameters not included in the : ALTLOG command retain their current values. You must have 
User Logging (LG) capability to execute : ALTLOG. Only the creator of the logging identifier can alter its 
attributes. 

To use the AUTO parameter, the log process for logid must be enabled for changing. You may do this by 
ending the log filename with the numeric characters "001 " (z.g.fname001). This name convention works 
in conjunction with the f ileset number to generator sequential filenames automatically. 



NOTE 



If a new log filename is specified with the : ALTLOG com- 
mand, the links with any previous log file will be broken. 



EXAMPLE 



To change the destination log file of the logging identifier KIM to log file C and specify that C resides on 
disc, enter: 

: ALTLOG KIM; 1.00=0, DISC 

Since the keyword parameter, "PASS- 1 , was not included, KIM retains any password previously specified. 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005). MPE Intrinsics 
Reference Manual (32003-90007) 
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:ALTSEC 



Alters a file's security provisions and manipulates Access Control Definitions (ACDs) associated with files 
and devices. 



SYNTAX 



;ALTSEC objectname[+ {FILENAME} 

{LDEV } 
{DEVCLASS}] 



1< [ACCESS= 
{NEWACD= 

{COPYACD^ 

{ADDPAIR= 

{REPPAIR= 

{DEL PAIR; 

{DELACD} 



] (fileaccess[ %fileaccess[ ;...]])} 
{ {acd pair[ \acd pair [;...]])} 

{^filereference} } 
--{objectname [, {FILENAME} 

{LDEV }]}} 
{ {acd pair[ \acd pair [;...]])} 
{ "7"i I ereference } } 
{{acd pair[\acd pair [;...]])} 
{ "fi lereference } } 
-{{user spec[\user spec[\. . .]])} 
{ "fi I ereference } } 



PARAMETERS 

objectname 



ACCESS 



Specifies an actual file designator (FILENAME), a logical device number 
(LDEV), or a device class name (DEVCLASS). (FILENAME is the default.) 

For files, the actual file designator of the file for which security provisions 
are to be altered, is written in the format: 

filename[/lockword] [ .groupname[.acctname] ] 

In a batch job if a lockword exists, it must be specified. In a session if a 
lockword exists and is omitted, MPE will prompt for it. If 
groupname .account name is not specified, MPE assumes the logon group 
and account. 

If a logical device number (LDEV) is specified, it must be configured in the 
system device configuration. 

If a device class name (DEVCLASS) is specified, it must be configured in the 
system device configuration. 

Identifies the alteration to the file access specifications at the file level. 
Note that this keyword is not applicable when the object is an ldev or a 
devclass. 
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fileaccess 



File security specifications, entered as R, L, A, W, and X which specify modes 
of access, and ANY, AC, GU, AL, and GL which specify types of users, ar? as 
follows: 



(R) 


{ANY} 


{L} 


{AC } 


(A) [,...]: 


{GU >[,. 


<w} 


{AL } 


{X} 


{GL ) 



.] 



If two or more modes are specified they must be separated by commas. The 
mode types are specified as follows: 



R 
L 
A 
W 
X 



Read 

Lock (allows opening with dynamic locking option) 

Append (implicitly specifies L also) 

Write (implicitly specifies A and L also) 

Execute 



If two or more user types are specified they must be separated by commas. 
Default is R, L, W, A X: ANY. The colon (:) separating one or more modes 
from one or more user types is required punctuation in the specification of 
fileaccess. 



ANY 


= 


Any user 


AC, 


s 


Member of this account only 


GU, 


B 


Member of this group only 


AL, 


c 


Account librarian user only 


GL, 


- 


Group librarian user only 


CR 


= 


Creating user only 


EXAMPLE: 


ACCESS = 


(R,W:ANY;A,L,X:CR) 



NEWACD 



acd pair 



Identifies the addition of a new Access Control Definition (ACD) to an 
object. 

An acd pair is specified in the same manner as fileaccess (see above). 
Both a modes and user spec specification must be supplied. The acd 
pair is specified in the form: 

■modes : user spec 

If acd pair is specified in a command line, separate the pairs with a 
semicolon, and enclose the entire ACD specification within parentheses. 
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modes 



Specifies types of access and permissions. This can be a combination of any 
of the following types of access and permissions, separated by a comma: 



R 

W 

L 

A 

X 

NONE 

RACD 



Read 

Write 

Lock 

Append 

Execute 

No Access 

Copy or read the ACD permission 



user spec 



^filereference 



COPYACD 
ADDPAIR 

REPPAIR 

DELPAIR 

DELACD 



Specifies a fully qualified user name defined by username .accountname. 
Multiple user names are specified separated by a comma. Wildcards may be 
substituted for the username or for both the username and the 
accountname as follows: 

@ .accountname : Represents all users in accountname. 

@ . @ : Represents all users in the system. 

The name of the file containing acd pairs. The acd pairs may be 
placed on separate lines, but a single pair may not span more than one line. 
The acd pair may be enclosed within parentheses. For example, 

(acd pair; 
acd pair) 

The " indicates that the contents of the file will be used, not the name. 

The contents of the indirect file must contain syntactically correct acd 
pairs enclosed within parentheses. A file reference has the following 
format: 

filename[/lockti>ord] [ .groupname[ .acctname] ] 

If the file has a lock word, it must be specified. If groupname. 
accountname is not specified, MPE assumes the logon group and account. 
System files such as $STDIN are not allowed. 

Identifies the filename or Idev whose ACD is to be copied. 

Identifies the Access Control Definition (ACD) pairs to be added to an 
existing ACD. 

Identifies an Access Control Definition (ACD) pair which will replace an 
existing ACD. 

Identifies the Access Control Definition (ACD) pair to be deleted. Only a 
user spec need be specified in DEL PAIR. 

Deletes all Access Control Definitions from an object. 
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USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts 
execution). 

OPERATION 

The : ALTSEC command manipulates Access Control Definitions (ACDs) associated with files and devices. 

: ALTSEC enables users to establish or alter the security provisions for any disc file. It permanently deletes 
all previous provisions specified for a file at the file level, and replaces them with those defined by the 
current .-ALTSEC parameters. This operation is done by defining the new file level access provisions 
within parentheses. It is recommended that the ACCESS keyword be used to identify the file access 
operation. 

ACD manipulation is processed with : ALTSEC by using one of the descriptive keywords associated with 
ACD operations such as NEWACD, COPY ACD, ADDPAIR, REPPAIR, DELPAIR, or DELACD. 

If an ACD exists for a file, it takes precedence over any file access restrictions added with the ACCESS 
keyword. 

EXAMPLE 

You have created a file named FDATA and you want to change its security provisions to allow write access 
to yourself only. There will be no default security provisions. Enter: 

: ALTSEC FDATA;ACCESS=(W:CR) 

To change the security provisions for a program file (FPROG) so that any group user can execute the 
program, but only account and group librarian users can read or write to the file, enter: 

: ALTSEC FPROG;ACCESS=(X:GU;R,W: AL,GL) 

To set access modes and associate an ACD with a file or device, enter: 

: ALTSEC APPA; NEWACD="ACDINFO 

The file ACDINFO contains the ACD information which will now be associated with the file APPA The 
contents of ACDINFO file is: 

R : MANAGER. SYS; 
X : USER 1. ACCOUNT 1 

ADDITIONAL DISCUSSION 

MPE V Intrinsics Reference Manual (32033-90007) 

MPE File System Reference Manual (30000-90236) 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 

MPE V Account Structure and Security (32033-901 36) 
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:ALTSPOOLFILE 



Alters the characteristics of an output spoolfile. 

SYNTAX 



[\?Rl=out put priority] 
[\CQPIZ$=numcopies ] 

rALTSPOOLFILEJf^h-DEV^^? > }[;. 
{ldeo1} L ' {deoclass} Jl * 

[jDEFER ] 



PARAMETERS 

#0/7/W 

Ideal 

out put priority 

numcopies 



ldeo2 or 
deoclass 



DEFER 



The output devicefile identification of a spoolfile. 

The logical device number of the device where an ACTIVE spoolfile 
currently resides. 

Specifies the output priority of the designated devicefile (0 = lowest; 1 4 
= highest). 

Specifies the number of copies to be produced from the designated 
devicefile. Range is 1 through 127; default is 1. 

Specifies the logical device number or device class name of the spoolfile's 
destination device. If ACTIVE, the file is returned to the READY state. It 
may immediately become ACTIVE on ldev2 if all requirements are met. 

Immediately changes the output priority of an ACTIVE or READY 
spoolfile to 0. If ACTIVE, the file is returned to the READY state. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is 
executable from the Console by users with OP or SM capability; it also may be distributed to users with 
the : ALLOW or : ASSOCIATE commands. 



I 
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OPERATION 

The Operator uses : ALTSPOOLFILE to change the printing priority of a spoolfile, to increase or decrease 
the number of copies produced, and/or to change the destination device or class. 

When altering an ACTIVE spoolfile, first take the output device offline. This gives you time to enter the 
command and determine that the ACTIVE spoolfile is the file being printed. When the : ALTSPOOLFILE 
command has been sent to the spooler process, MPE returns the colon prompt ( : ). No change to the 
spoolfile will be made, however, until the output device is returned online. 

You may alter the outputpriority or the numcopies of an ACTIVE spoolfile without interrupting the 
printing process. If you alter the device or defer the ACTIVE spoolfile with the DEFER parameter, the 
printer will stop immediately. In both of these cases, the entire file will be printed when printing resumes. 
Deferring a spoolfile lowers its output priority to zero, the lowest priority possible. To print a deferred 
spoolfile, you must raise its priority above the current OUTFENCE using the : ALTSPOOLFILE command. 

If you intend to print a spoolfile on an HP 2680A Laser Page Printer, you may add an environment file to 
it before printing. Instructions for this procedure can be found in the MPE V System Utilities Reference 
Manual (32033-90008) in the discussion of the SPOOK subsystem >COPY command. 

EXAMPLES 

To defer the ACTIVE spoolfile (#086 ) on Idev 6 take device 6 offline, then enter: 

: ALTSPOOLFILE #086; DEFER 
or 

: ALTSPOOLFILE 6;DEFER 
To change the priority of deferred spoolfile #01 23 from to 3 enter: 

:ALTSP00LFILE #0123;PRI=3 
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:ALTUSER 



Alters attributes currently defined for a user. 

SYNTAX 



:ALTUSER username[ accountname] 
[|PASS= [password] ] 
[|CAP= [capabilitylist ] ] 
[^MPiKPRl = [subqueuename] ] 
[|LOCATTR= [localattribute]] 
[§H(ME=[homegroupname] ] 
[|USERPASS= [ |^| ] [pXPIRED] ] ( 1 ) 



PARAMETERS 

username 
accountname 



password 



capabilitylist 



The name assigned to the user within a logon account. 

As System Manager you can include the account name when logged onto an 
account other than the requested account. 

The new password to be assigned to the user. When ";PASS= IRETURN) " is 
entered, any existing password is removed. If this parameter is omitted en- 
tirely, the password will remain unchanged. 

The list of capabilities, separated by commas, permitted to this user. The 
capabilities assigned to the user cannot exceed those assigned to the ac- 
count. Each capability is denoted by a two-letter mnemonic as follows: 



System Manager 


= 


SM 


Account Manager 


= 


AM 


Account Librarian 


= 


AL 


Group Librarian 


= 


GL 


Diagnostician 


= 


DI 


System Supervisor 


= 


OP 


Network Administrator 


= 


NA 


Node Manager 


= 


NM 


Permanent Files 


= 


SF 


Access to non-sharable 






I/O devices 


= 


ND 


Use Volumes 


= 


UV 


Create Volumes 


= 


CV 



( 1 ) The USERPASS parameter is only available if HP Security Monitor (HP30392) has been installed. 
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subqueuename 



Use Communications 

Subsystem 
User Logging 
Process Handling 
Extra Data Segments 
Multiple RINs 
Privileged Mode 
Interactive Access 
Local Batch Access 
Programmatic Sessions 



CS 
LG 
PH 
DS 
MR 
PM 
IA 
BA 
PS 



Default is SF , ND, I A , and BA . Note that CV automatically gives the user 
UV capability. 

The name of the highest priority subqueue that may be requested by any 
process of any job/session initiated by the user. This parameter is specified 
as AS , BS , CS , DS , or ES, but cannot be greater than that specified with 
the :NEWACCTor : A LTACCT commands. The subqueuename defined for the 
user is checked against the subqueuename defined for the account at logon, 
and the lower priority of the two is used as the maximum priority restrict- 
ing all processes of the job/session. Also, the priority requested by the user 
when he or she logs on is checked against the subqueuename defined for the 
user, and he or she is granted the lower of these two values. Default is CS . 



CAUTION 



Processes capable of executing in the AS or BS subqueues can 
deadlock the system. By assigning non -priority processes to 
these subqueues, you may prevent critical system processes 
from executing. Exercise extreme care when assigning 
processes to the AS or BS subqueue. 



I ocalat tribute 



homegroupname 



REQ 



OPT 



Defined at the installation site, this is an arbitrary double word bit map 
used to further classify users. When it is not part of standard MPE security 
provisions, programmers may define it (through the WHO intrinsic) to en- 
hance the security of their own programs. The bit map for the user local 
attributes must be a subset of the bit map for the account local attributes. 
The :ALTL)SER command checks the local attributes of the user with those 
of the account. Default is double word (null). 

The name of an existing group to be assigned as the home group for this 
user. The first user established when an account is created will by default 
have PUB assigned as the homegroup. Subsequent new users will by default 
have no homegroup assigned. If no homegroup is assigned, the user must al- 
ways specify an existing group when logging on. 

USERPASS=REQ specifies that the user must have a non-blank password. It 
is available only if HP Security Monitor has been installed. Refer to the 
HP Security Monitor Users Guide for more information. 

USERPASS=OPT specifies that this user may or may not have a password. It 
is available only if HP Security Monitor has been installed. 
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EXPIRED 



The password expires immediately. The user cannot logon without selecting 
a new password. It is available only if HP Security Monitor has been 
installed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK, 
must have Account Manager (AM) capability to use this command. 



It is not Breakable. A user 



OPERATION 

The rALTUSER command allows the Account Manager to change the password, capabilities, processing 
subqueue, security checking, and home group currently defined for a user. More than one of these at- 
tributes may be changed at a time, by entering multiple keyword parameters on a single command line, 
using the | delimiter. 

To change an attribute, enter the keyword and its new value. If you enter the keyword and no cor- 
responding parameter, the default value is assigned. When an entire keyword parameter group is omitted 
from the rALTUSER command, the corresponding value for the user remains unchanged. When a keyword 
is included, but the corresponding parameter is omitted (as in ; PASS= ), a default value is assigned as 
follows: 



PARAMETER 


DEFAULT VALUES 


password 


Null (no password) 


capabilitylist 


SF , ND , IA , and BA (provided these capabilities have been 
specified for the account) 


subqueuename 


CS 


localattribute 


Null (double word ) 


homegroupname 


The first user established when the account is created has 
PUB assigned as home. Subsequent users have no group 
assigned as home. If a user has no home group assigned, an 
existing group must be specified when initiating a job or a 




session. 



When a parameter is modified with the rALTUSER command, it is immediately registered in the directory. 
However, it will not affect users who are currently logged on to the system. They will be affected the 
next time they logon to the same user name and account. For this reason, you should warn users in ad- 
vance of the intended changes. 

You should avoid changing the capabilitylist or homegroupname of the user MANAGER. SYS. SM capability 
cannot be taken away from MANAGER . SYS. 
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If more than one user within an account is assigned AM capability, the capability can be removed from all 
but one (the last) user assigned it. 

EXAMPLES 

Suppose an account's capabilities are AM , AL , GL , SF , ND , PH , DS , MR , IA , and BA . To change the 
capabilitylist of the user JONES from IA , BA , SF , PH , DS to include Multiple RIN capability ( MR ), enter: 

: ALTUSER JONES;CAP=IA,BA,SF,PH,DS,MR 

To alter two attributes, password and subqueuename, for user JONES enter: 

: ALTUSER JONES ;PASS=JJ;MAXPRI=DS 

ADDITIONAL DISCUSSION 

HP Security Monitor Users Guide (30392-90001) 
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:ALTVSET 

Modifies volume set definitions. 

SYNTAX 



:ALTVSET Dsname 

[§ i ^ODCLfi i SS=Ocname: oname[ioname[^ . . . ] ] ] 
[lEXPANDCLASS=i>cna/ne: vname[§vname[l. . .]]] 
[%EXPPMDSEJ=i)name:typeUvname:type[i. . .]]] 



PARAMETERS 

Vsname 
Vcname : vname 



ADDCLASS 



EXPANDCLASS 



EXPANDS ET 



The existing volume set name. MPE will implicitly reference vsname as 
vsname. groupname. acctname, where groupname and acctname are the logon 
group and account. 

The volume class name, consisting of up to eight alphanumeric characters, 
beginning with an alphabetic character. Each volume class definition con- 
sists of a volume class name and an associated list of volume names, vname. 
The list of volume names must be a subset of the volumes composing the 
volume set. One of the volume names must be that of the volume set's 
master volume. 

Directs MPE to add a volume class and an associated list of volume names 
to an existing volume set. The list of volume names must be a subset of the 
volumes comprising the volume set. One of the volume names must be that 
of the volume set's master volume. 

Directs MPE to add the names of new members in the volume class to an 
existing volume set. These new members can only be members of the parent 
volume set. 

Directs MPE to add the names of new members in the volume set and types 
of devices required to accommodate the new members to an existing volume 
set. Total members in a volume set may not exceed eight. The type must be 
specified with each volume member name to define the type of disc drive. 
Types of disc drives that may be specified are: 



HP 7902 
HP 7905 
HP 7906 
HP 7911 
HP 7912 
HP 7914 



HP 7920 
HP 7925 
HP 7933 
HP 7935 
HP 7945 
HP 9895 
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USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Create Volume (CV) capability to use this command. 

OPERATION 

The :ALTVSET command is used to modify volume set definitions. Volume class names may be added, and 
the number of member volumes may be increased. The overall size of the volume set, however, cannot be 
decreased by deleting member volumes. rALTVSET will not alter a volume set if it is in use, i.e., if an ex- I 

plicit or implicit mount has been issued. § 

EXAMPLE 

To add member volumes MEM3 and MEM4 to the existing volume set USERSET, enter: 
: ALTVSET USERSET;EXPANDSET=MEM3; HP7920,MEM4:HP7920 

ADDITIONAL DISCUSSION 

Refer to the discussion of "PRIVATE VOLUMES" in the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). 
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:ASSOCIATE 

Gives a user Operator control of a device. 

SYNTAX 



: ASSOCIATE devclass 



PARAMETERS 

devclass The name of a logical device class configured during SYSDUMP. 

USE 

This command may be issued from a Session, Program, or in BREAK. It may not be used from a Job. It is 
not Breakable. 



OPERATION 

This command links a device class, such as LP, to an individual user on the system. The user may then ex- 
ecute any valid Operator command for a device in the device class and will receive the status messages for 
the devices in that device class on $STDLIST. For example, a remote printer may be associated with a 
terminal, so that messages concerning the printer will go to the terminal, not the System Console. 

Before a user can be associated, the System Manager must run a utility program (the version of 
AS0CTBL5. PUB. SYS that matches your operating system) in order to create a device class/user association 
table. This table defines which users may be associated with which device classes. At any given time, 
only one user may be associated with a given device class. If the device belongs in several device classes, 
only one of those device classes may be associated. 

Certain commands are only on G. 00. 00 and later releases of MPE. These commands are designated by 
G. 00. 00. The Operator commands which are made available to users through the : ASSOCIATE command 
are: 



ABORT 10 

ACCEPT 

ALTSPOOLFILE 

DELETESPOOLFILE 

DISCRPS (G. 00.00) 

DOWN 

DOWNLOAD 

FOREIGN 

GIVE 

HEADON 

HEADOFF 

OPENQ (G.00.00) 



OUTFENCE 

MPLINE 

REFUSE 

REPLY 

RESUMESPOOL 

SHOWCOM 

SHUTQ (G.00.00) 

STARTSPOOL 

STOPS POOL 

SUSPENDS POOL 

TAKE 

UP 
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Both the System Supervisor and the user may : DISASSOCIATE a user from a device. In addition, a user 
implicitly disassociates a device when logging off. 



EXAMPLE 

To be the controller of the device class "TAPE", enter: 
: ASSOC I ATE TAPE 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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AUTOALLOCATE 



Disables or enables the automatic allocation/deallocation of programs. 

SYNTAX 



: AUTOALLOCATE j£JT* 



PARAMETERS 

OFF Turns off the automatic allocation/deallocation of programs. Also unloads 

all programs which have been loaded by this feature if they are not being 
used. 

ON Starts the automatic allocation/deallocation of programs. 



USE 

This command may be issued from a session, job, program or in BREAK mode. It is not breakable . A user 
must have System Supervisor (OP) capability to use this command. 

OPERATION 

This feature will manage the automatic allocation/deallocation of programs in such a way that it is 
transparent to the user. This feature will reduce system overhead caused by loading programs for execu- 
tion. It will also increase the average response time of the "RUN" command. It will NOT make programs 
execute faster. 

As programs are run, they will be automatically allocated (see the ALLOCATE command). When the 
program terminates, it will stay in the autoallocated state. The next time the program is run, it will take 
much less time to load the program for execution. Programs will stay in the autoallocated state after they 
are run until a resource which the program holds is needed. When this occurs, the program which has not 
executed for the longest amount of time will be automatically deallocated and the resource it holds will be 
released. 

Note, since temporary program files and program files on private volumes can not be allocated by the 
MPE ALLOCATE command they, will not be autoallocated. 

EXAMPLES 

To start the automatic allocation/deallocation of programs, enter: 

: AUTOALLOCATE ON 
To stop the automatic allocation/deallocation of programs, enter: 

: AUTOALLOCATE OFF 
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:BASIC 



Interprets a BASIC program. BASIC is not part of the HP 3000 Fundamental Operating Software and 
must be purchased separately. 



SYNTAX 




PARAMETERS 

conwandfile 
in put file 
listfile 



Actual file designator of the sourcefile or device from which BASIC com- 
mands and statements are input. This can be any ASCII input file. Formal 
file designator is BASCOM. Default is $STDINX. 

Actual file designator of the file containing data input for a BASIC 
program. This can be any ASCII input file. Formal file designator is 
BASIN. Default is $STDI NX. 

Actual file designator of the destination file for the program listing and 
output. This can be any ASCII output file. Formal file designator is 
BASLIST. Default is $STDLIST. 



USE 



NOTE 



The formal file designators used in this command (BASCOM, 
BASIN, and BASLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the :FILE command. 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The : BASIC command is generally used for online programming in BASIC, but it can also be used to in- 
terpret BASIC programs submitted in batch mode. In batch mode, the BASIC >EOD command is required 
after any data following the BASIC >RUN command, or after the >RUN command itself if there is no data. 
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EXAMPLES 

To enter commands and data from your standard input device, with program listing and output transmit- 
ted to the standard output device, enter: 

: BASIC 

You may also submit commands and data to the BASIC interpreter through input files that you have 
stored on disc. Files created using the Editor Subsystem must be kept with the UNN (unnumbered) option 
of the Editor's Subsystem KEEP command. In this example, BASIC interpreter commands and statements 
are submitted from the command file MYCOMDS. The data that the program uses is stored in the input file 
MYDATA. The program listing and output are written to the file MYLIST. 

: BASIC MYCOMDS »MYDATA,MYLIST 

ADDITIONAL DISCUSSION 

BASIC/ 3 000 Interpreter Manual (32103-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:BASICGO 



Compiles, prepares, and executes a BASIC program. BASIC is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 

SYNTAX 



BASICGO [cornnandfile][glistfile] 



PARAMETERS 

commandfile Actual file designator of the input file from which the BASIC compiler 

commands are read. This can be any ASCII input file. Formal file desig- 
nator is BSCTEXT. Default is $STDINX. 

listfile Actual file designator of the file to which the program listing is written. 

This can be any ASCII output file. Formal file designator is BSCLIST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command (BSCTEXT, 
and BSCLIST) cannot be backreferenced as actual file desig- 
nators in the command parameter list. Refer to the 
"Implicit :FILE Commands For Subsystems" discussion of the 
MPE :FILE command for further information. 



USE 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

This command compiles, prepares, and executes a program from a "fastsave" file created by the BASIC in- 
terpreter. This enables the program to run faster than it would if it were executed by the interpreter. 

To save the program after it is written, use the BASIC interpreter command SAVE filename , FAST. The 
program then can be compiled, prepared, and executed with the : BASICGO command. You must specify 
the FAST option to compile the program. 
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EXAMPLE 

To compile, prepare, and execute the BASIC program MYPROC, enter: 

: BASICGO ** Calls the BASIC compiler. ** 

$ CONTROL US LI NIT ** Initializes USL. ** 

$ COMPILE MYPROG ** Compiles program MYPROG. ** 

$ EXIT ** Exits from compiler. ** 

ADDITIONAL DISCUSSION 

BASIC Compiler Reference Manual (32103-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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rBASICOMP 



Compiles a BASIC program. BASIC is not part of the HP 3000 Fundamental Operating Software and 
must be purchased separately. 



SYNTAX 



BASICOMP [conrnzndfile] IMluslfile] [ilistfile]] 



PARAMETERS 

conmandfile 
uslfile 



list file 



Actual file designator of the input file from which the compiler commands 
are read. This can be any ASCII input file. Formal file designator is 
BSCTEXT. Default is $STDI NX, 

Actual file designator of the User Subprogram Library (USL) file to which 
the object code is written, which can be any binary output file with file 
code of USL or 1024. Its formal file designator is BSCUSL If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$OLDPASS. If entered, this parameter specifies that the file was created in 
one of four ways: 

• By using the : SAVE command to save the default USL file $OLDPASS , 
created by a previous compilation. 

• By building the USL with the Segmenter command -BUI LDUSL (refer to 
the MPE Segmenter Reference Manual (30000-9001 1)). 

• By creating a new USL file with the MPE : BUI LD command and a file 
code of USL or 1024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file on which the program listing is written. 
This can be any ASCII output file. Formal designator is BSCLIST. Default 
is $STDLIST. 



NOTE 



The formal file designators used in this command (BSCTEXT, 
BSCUSL, and BSCLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the MPE :FILE command. 
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USE 

This command may be issued from a Session, or Job. It may not be used from a Program, or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

The : BASICOMP command compiles a program from a "fastsave" file generated by the BASIC interpreter. 
If you do not specify a USL file, the BASIC compiler stores the object code in the default system defined 
temporary file $OLDPASS, as shown in the second example, below. You may, however, build a USL file in 
the permanent file domain, then direct the BASIC compiler to store the object code in this file by naming 
the USL file in the : BASICOMP command line. The first example, below, does this. 

EXAMPLE 

To compile the BASIC program MY PROG onto the USL named OBJECT, enter: 

: BUILD OBJECT;CODE=USL ** Builds USL file. ** 

; BASICOMP, OBJECT ** Calls BASIC compiler; specifies USL named OBJECT. ** 

$ CONTROL USLINIT ** Initializes USL. ** 

$ COMPILE MYPROG ** Compiles fastsave program named MYPROG. ** 

$ EXIT ** Exits from compiler. ** 

If you do not choose to build a USL file, the : BASICOMP command compiles your program, storing the ob- 
ject code in the default USL file $OLDPASS. 

: BASICOMP ** Runs BASIC compiler, accepting commands from SSTDINX, and 

specifying SOLDPASS the USL output and SSTDLIST for listing 
output. ** 

$ COMPILE MYRUN ** Compiles from fastsave filenamed MYRUN into a USL named 

SOLDPASS.** 

$ EXIT ** Exits from BASIC compiler. ** 

If you now want to run your program, use the : PREPRUN command: 
: PREPRUN $OLDPASS ** Prepares and runs program. ** 



ADDITIONAL DISCUSSION 



BASIC Compiler Reference Manual (32103-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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rBASICPREP 



Compiles and prepares a BASIC program. BASIC is not part of the HP 3000 Fundamental Operating 
Software and must be purchased separately. 



SYNTAX 



: BASICPREP [commandfile] [§ [prog file] [glistfile] ] 



PARAMETERS 

commandfile 
prog file 



list file 



Actual file designator of the input file from which the compiler commands 
are read. This can be any ASCII file. Formal file designator is BSCTEXT. 
Default is $STDI NX. 

Actual file designator of the program file on which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When progfile is omitted, the MPE Segmenter creates the 
program file, which will reside in the temporary file domain as $OLDPASS. 
If you do create your own program file, you must do so in one of two ways: 

• Using the MPE : BUILD command, and specifying a file code of 1029 or 
PROG and a numextents value of 1. This file is then used by the :PREP 
command. 

• Specifying a nonexistent file in the progfile parameter, in which case 
a temporary job file of the correct size and type is created. 

Actual file designator of the file to which the listing is written. This can be 
any ASCII output file. Formal file designator is BSCLIST. Default is 
$STDLIST. 



NOTE 



The formal file designators used in this command ( BSCTEXT, 
and BSCLIST) cannot be backreferenced as actual file desig- 
nators in the command parameter list. For further informa- 
tion, refer to the "Implicit:FILE Commands For Subsystems" 
discussion of the MPE :FILE command. 



USE 

This command may be issued from a Session or Job. 
is Breakable (suspends execution). 



It may not be used from a Program or in BREAK. It 
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OPERATION 

The :BASICPREP command compiles and prepares a program for execution from a "fastsave" file 
generated by the BASIC interpreter. If you omit the progfile parameter, the prepared program segments 
are stored in the system defined temporary file $OLDPASS. If you want to save the prepared program in a 
file other than $OLDPASS, you may either create a file and specify its filename on the :BASICPREP 
command line, or specify a non-existent progfile. 

A program that you have compiled and prepared with the : BASICPREP command may be executed with 
the MPE : RUN command. 

EXAMPLE 

To compile and prepare a program named MY PROG from the BASIC fastsave filenamed MYCOMDS, with list- 
ing directed to the standard list device, enter: 

; BASICPREP, MYCOMDS 

The file MYPROG is an ASCII file that contains the following BASIC compiler commands: 

$CONTROL USLINIT .SOURCE ** Initializes USL and lists program. ** 

$COMPILE MYPROG ** Compiles fastsave program. ** 

$EXIT ** Exits from compiler. ** 

ADDITIONAL DISCUSSION 

BASIC Compiler Reference Manual (32103-90001) 
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BBASIC 



Interprets a HP Business BASIC program. HP Business BASIC is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 

SYNTAX 



: BBASIC [conmandfile] [g[inputfile] [^listfile]] 



PARAMETERS 

conmandfile Actual file designator of the sourcefile or device from which BBASIC com- 

mands and statements are input. This can be any ASCII input file. Formal 
file designator is BASCOM. Default is $STDINX. 

in put file Actual file designator of the file containing data input for a BBASIC 

program. This can be any ASCII input file. Formal file designator is 
BASIN. Default is $STDI NX. 

outfile Actual file designator of the destination file for the program listing and 

output. This can be any ASCII output file. Formal file designator is 
BASOUT. Default is $STDLIST. 



NOTE 



The formal file designators used in this command (BASCOM, 
BASIN, and BASOUT) cannot be backreferenced as actual file 
designators in the command parameter list. For further in- 
formation, refer to the "Implicit FILE Commands For 
Subsystems" discussion of the MPE :FILE command. 



USE 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK.. It 
is Breakable (suspends execution). 

OPERATION 

The : BBASIC command is generally used for online programming in BASIC, but it can also be used to in- 
terpret BASIC programs submitted in batch mode. In batch mode, the BASIC >EOD command is required 
after any data following the BASIC >RUN command, or after the >RUN command itself if there is no data. 
Business BASIC has its own online HELP facility. 
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EXAMPLE 

To enter commands and data from your standard input device, with program listing and output transmit- 
ted to the standard output device, use: 

; BBASIC 

You may also submit commands and data to the BBASIC interpreter through input files that you have 
stored on disc. Files created using the Editor must be kept with the UNN (unnumbered) option of the 
Editor's KEEP command. In this example, BASIC interpreter commands and statements are submitted 
from the command file MYCOMDS. The data that the program uses is stored in the input file MY DATA The 
program listing and output are written to the file MY LI ST. 

; BBASIC MYCOMDS, MYDATA.MYLIST 

ADDITIONAL DISCUSSION 

HP Business BASIC Reference Manual (321 15-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:BBASICGO 



Compiles, prepares, and executes an HP Business BASIC program. HP Business BASIC is not part of the HP 
3000 Fundamental Operating Software and must be purchased separately. 

SYNTAX 



BBASICGO infileiilistfile] 



PARAMETERS 

in file Actual file designator of the BSAVE file containing the BBASIC program to 

be compiled. Formal file designator is BBC IN. 

list file Actual file designator of the file to which the program listing is written. 

This can be any ASCII output file. Formal file designator is BBC LI ST. 
Defaultis$STDLIST. 



NOTE 



The formal file designators used in this command (BBCIN, 
and BBC LIST) cannot be backreferenced as actual file 
designators in the command parameter list. Refer to the 
"Implicit :FILE Commands For Subsystems" discussion of the 
MPE .FILE command in this section. 



USE 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

This command compiles, prepares, and executes a program from a BSAVE file created by the BBASIC 
interpreter. This enables the program to run faster than it would if it were executed by the interpreter. 

You may create a BSAVE program file within the BBASIC interpreter after it is saved by using the 
BBASIC interpreter command >SAVE filename. The program then can be compiled, prepared, and 
executed with the : BBASICGO command. 
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EXAMPLE 

To compile, prepare, and execute the BBASIC program MY PROG and send the listing to the disc file 
LISTFL, enter: 

: BBAS I CGO MY PROG , L I STF L ** Compiles, prepares, and runs the program MYPROG. ** 

ADDITIONAL DISCUSSION 

HP Business BASIC Reference Manual (321 15-90001) 
Basic Compiler Reference Manual (321 03-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 



I 
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:BBASICOMP 



Compiles an HP Business BASIC program. HP Business BASIC is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 

SYNTAX 



PARAMETERS 

in file Actual file designator of the BSAVE file containing the BBASIC program to 

be compiled. This can be any ASCII input file. Formal file designator is 
BBC IN. 

uslfile Actual file designator of the User Subprogram Library (USL) file on which 

the object program is written, which can be any binary output file with file 
code of USL or 1024. Its formal file designator is BBSCUSL. If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$0LDPASS. If entered, this parameter specifies that the file was created in 
one of four ways: 

• By using the :SAVE command to save, the default USL file $0LDPASS 
created by a previous compilation. 

• By building the USL with the Segmenter command -BUILDUSL. Refer 
to the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file with the MPE : BUILD command and 
specifying a file code of USL or 1024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

List file Actual file designator of the file on which the program listing is written. 

This can be any ASCII output file. Formal designator is BBC LI ST. Default 
is $STDLIST. 



NOTE 



The formal file designators used in this command (BBCIN, 
BBCUSL, and BBCLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the MPE : FILE command. 
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USE 

This command may be issued from a Session, or Job. It may not be used from a Program, or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

The : BBASICOMP command compiles a program from a BSAVE file generated by the BBASIC interpreter. 
This enables the program to run faster than it would if it were left in the form generated by the 
interpreter. 

A BSAVE program file can be created from within the BBASIC interpreter after it is written, by using the 
BBASIC interpreter command >SAVE filename. The program may be compiled with the : BBASICOMP 
command, then prepared with the MPE command : PREP, and executed with the MPE command : RUN. 



EXAMPLES 

To compile the BBASIC program MY PROG onto the USL named OBJECT, enter: 

: BBASICOMP MYPROO, OBJECT 

If you do not choose to build a USL file, the : BASICOMP command compiles your program, storing the 
object code in the default USL file $OLDPASS. 

; BBASICOMP MYPROO ** Runs BASIC compiler and accepts MY PROG as a BSAVE program file. 

SOLDPASS is the default USL, and SSTDLIST is the default output 
listing. ** 

If you now want to run your program, use the : PREPRUN command: 

; PREPRUN $OLDPASS ** Prepares and runs program. ** 

ADDITIONAL DISCUSSION 

HP Business BASIC Reference Manual (321 1 5-90001) 
Basic Compiler Reference Manual (32103-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:BBASICPREP 



Compiles and prepares a HP Business BASIC program. HP Business BASIC is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 

SYNTAX 



:BBASICPREP infile\i[progfile] Iglistfile]] 



PARAMETERS 

in file 

progfile 



Actual file designator of the BSAVE file containing the BBASIC program to 
be compiled. Formal file designator is BBCIN. 

Actual file designator of the program file on which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When progfile is omitted, the MPE Segmenter creates the 
program file, which will reside in the temporary file domain as $0LDPASS. 
If you do create your own program file, you must do so in one of two ways: 

• Using the MPE : BUILD command, and specifying a file code of 1 029 or 
PROG and a numextents value of 1. This file is then used by the : PREP 
command. 



listfile 



• Specifying a nonexistent file in the progfile parameter, in which case 
a temporary job file of the correct size and type is created. 

Actual file designator of the file on which program the listing is written. 
This can be any ASCII output file. Formal file designator is BBCLIST. 
Default is $STDLIST. 



NOTE 



USE 



The formal file designators used in this command ( BBCIN, 
and BBCLIST) cannot be backreferenced as actual file desig- 
nators in the command parameter list. For further informa- 
tion, refer to the "Implicit:FILE Commands For Subsystems" 
discussion of the MPE :FILE command. 



This command may be issued from a Session or Job. 
is Breakable (suspends execution). 



It may not be used from a Program or in BREAK. It 
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OPERATION 

The :BBASICPREP command compiles and prepares a program from a BSAVE file generated by the 
BBASIC interpreter. If you omit the progfile parameter, the prepared program segments are stored in the 
system defined temporary file $OLDPASS. If you want to save the prepared program in a file other than 
$OLDPASS, you may either create a file and specify its filename on the :BBASICPREP command line, or 
specify a non-existent progfile. 

A BSAVE program file can be created from within the BBASIC interpreter after it is written, by using the 
BBASIC interpreter command >SAVE filename. The program may be compiled with the :BBASICOMP 
command, then prepared with the MPE command PREP, and executed with the MPE command : PREP, and 
executed with the MPE command : RUN. 

EXAMPLE 

To compile and prepare a program named MY PROG from the BBASIC BSAVE filenamed MYCOMDS, and send 
the listing to the standard list device, enter: 

:BBASICPREP MYCOMDS, MY PROG 



ADDITIONAL DISCUSSION 

HP Business BASIC Reference Manual (321 1 5-90001) 
Basic Compiler Reference Manual (32103-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:BREAKJOB 

Suspends an executing job. 

SYNTAX 



:BREAKJOB tJnnrt 



PARAMETERS 

iJnnn A job number. 

USE 

This command may be issued from a Session, Job, or Program, and in BREAK. It is not Breakable. It is 
executable only from the Console. * 

* Unless distributed to users with the : ALLOW command, or if : JOBSECURITY is set LOW. 

OPERATION 

The Operator can use the :BREAKJOB command to suspend any executing job, including spooled and 
streamed jobs. A job using a critical system resource will not be suspended until it releases the resource. 

When you issue : BREAKJOB for a job that controls a nonsharable device, a console message is displayed 
listing the device(s) that the job controls. (As many as ten devices may be listed) You may then decide 
whether the job should be allowed to run until it releases the device(s), or whether it should be aborted. 

All commands that normally affect executing jobs, such as : ABORT JOB , will operate on suspended jobs. 
The : SHOWJOB command, which lists all jobs, will display "SUSP " for those in the suspended state. To list 
suspended jobs only, enter : SHOWJOB SUSP. 

EXAMPLES 

To suspend job number 68, enter: 

; BREAKJOB »J68 

To display suspended jobs, enter: 

: SHOWJOB SUSP 

JOBNUM STATE INPRI JIN JLIST INTRODUCED JOB NAME 

#68 SUSP 105 LP WED. 7:56AM TEST, USER. ACCOUNT 
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:BUILD 



Creates and immediately allocates a new empty file on disc. 



SYNTAX 



: BUILD filereference 

HREC- [recsize] \Miblockfaotor) [|[<U>] llfJ^JJ*}] 1 1 1 

r {|CCTL }, 
L {|NOCCTL} J 

[1TEMP] 

[]|jDEV= [ [dsde»ice]W\ [deoice]] 

[ICODE =filecode] 

[;DISC=[n«/nrec] \M[numextents] \^\initialloc\ ]]] 

r<|RIO >, 
1 <1|N0RI0} J 

{1STD} 

KlMSG}] 
<|CIR> 



PARAMETERS 

filereference 



recsize 



Actual name of the file to be created, in the following format: 

filename[/locktiord] [ ,groupname[ .acctname] ] 

Names must contain from one to eight alphanumeric characters, beginning 
with an alphabetic character. If acctname is specified, it must be that of 
your logon account (you cannot create a file in another account). The 
default groupname and acctname axe the logon group and account. 

The record size of a new file. A positive number specifies the size in words 
while a negative number specifies the size in bytes. For fixed length files, 
recsize is the logical record size. For undefined length files, recsize is the 
maximum record size. For variable length files using a blocking factor of 
1 , recsize is the maximum logical record size. If blockf actor is a value other 
than 1, recsize is used to calculate the maximum logical and physical record 
size. 



Since records always begin on word boundaries, the record size is rounded 
up to the nearest word boundary to calculate block size. If the file format 
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is binary or variable length ASCII, odd byte lengths are rounded up and the 
extra byte is not available for data. For example, in a fixed length ASCII 
file with recsize equal to 1 1 bytes, only 1 1 bytes will be available for data 
in each logical record. To determine the block size, recsize is rounded up to 
1 2 bytes. If the file format is binary, all 1 2 bytes, or 6 words, are available 
to store data. 



blockfactor 



F, U, or V 



The default record size is the configured physical record width of the as- 
sociated device. Disc files will have a record size of 128 works unless you 
specify a device other than DISC using the ; DEV- parameter. 

The number of logical records per physical block in a new file. The default 
is calculated by dividing the specified recsize into the configured block size; 
this value is rounded downward to an integer that is never less than 1. For 
variable length record files, blockfactor and recsize are used to calculate the 
maximum logical and physical record size. The blockfactor is then set to 1. 
For files containing undefined length records, the blockfactor is ignored. 
The maximum size of blockfactor is 255. 

Defines the length of the records of the file. A file may contain fixed 
length records (F), undefined length records (U), or variable length records 
(V). For disc files, the default is F. 



BINARY or 
ASCII 

CCTL or 
NOCCTL 



Indicates the type of records the file contains. BINARY indicates binary 
coded records and is the default. ASCI I indicates ASCII coded records. 

Indicates whether or not carriage control characters are supplied along with 
data written to an ASCII file. CCTL indicates carriage control characters 
accompany the data; NOCCTL indicates carriage control characters are not 
specified. The default is NOCCTL. 



TEMP 



dsdeoice 



device 



Indicates that the file will be created as a temporary jobfile and will be 
saved in the job/session temporary file domain when closed. Refer to the 
MPE File System Reference Manual (30000-90236) for more information 
on file domains. The default is that a permanent file is created. 

The device class name or logical device number used to open a communica- 
tions link to a remote computer that contains the source file. The default 
is the local system, or the computer on which the transfer request 
originates. A '# ' symbol is a delimiter between the filename of the remote 
computer and the remote devicef ilename. 

Specifies either the devclass or Idev on which the file is to reside. A device 
class name, devclass, consists of up to eight alphanumeric characters begin- 
ning with an alphabetic character, such as DISC or PVDISC1. When you 
specify devclass, the file is allocated to any available device in that class. If 
you are opening a file destined for a Private Volume, you must specify a 
device class which includes the drives upon which the home volume set is 
mounted. The file is then allocated to any of the home volume set's 
volumes that fall within that device class. 



The logical device number (Idev) consists of a one- to three-digit number 
specifying a particular device. Default is the device class name DISC. 
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filecode 



A code indicating a specially formatted file. This code is recorded in the 
file label and is available to processes accessing the file through the 
FFILEINFOor FGETINFO intrinsic. Although any user can specify a posi- 
tive integer ranging from to 32767 or mnemonic name for this parame- 
ter, certain reserved integers and mnemonics have particular system defined 
meanings, as follows: 



Integer Mnemonic Meaning 



1024 . 


USL 


1025 


BASD 


1026 


BASP 


1027 


BASFP 


1028 


RL 


1029 


PROG 


1030 


NMPRG 


1031 


SL 


1032 


NMSL 


1033 


NMRL 


1035 


VFORM 


1036 


VFAST 


1037 


VREF 


1040 


XLSAV 


1041 


XLBIN 


1042 


XLDSP 


1050 


EDITQ 


1051 


EDTCQ 


1052 


EDTCT 


1054 


TDPDT 


1055 


TDPQM 


1056 


TDPP 


1057 


TDPCP 


1058 


TDPQ 


1059 


TDPXQ 


1060 


RJEPN 


1070 


QPROC 


1080 


KSAMK 


1083 


GRAPH 


1064 


SD 


1090 


LOG 


1100 


WDOC 


1101 


WDICT 


1102 


WCONF 


1103 


W2601 


1110 


PCELL 


1111 


PFORM 


1112 


PENV 


1113 


PCCMP 


1114 


RASTR 


1130 


OPTLF 


1131 


TEPES 


1132 


TEPEL 


1133 


SAMPL 



User Subprogram Library 

BASIC Data 

BASIC Program 

BASIC Fast Program 

Relocatable library 

Program file 

Native Mode Program file 

Segmented Library 

Native Mode Executable Library file 

Native Mode Relocatable Library file 

View Form file 

View Fast Forms file 

View Reformat file 

Cross Loader ASCII file (SAVE) 

Cross Loader Relocated Binary file 

Cross Loader ASCII file (DISPLAY) 

Edit Quick file 

Edit KEEPQ file (COBOL) 

Edit TEXT file (COBOL) 

TDP Diary file 

TDP Proof Marked QMARKED 

TDP Proof Marked non-COBOL file 

TDP Proof Marked COBOL file 

TDP Workf ile 

TDP Workfile (COBOL) 

RJE Punch file 

QUERY Procedure file 

KSAM Key file 

GRAPH Specification file 

Self -describing file 

User Logging logfile 

HPWORD Document 

HPWORD Hyphenation dictionary 

HPWORD Configuration file 

HPWORD Attended Printer Environment 

IFS/3000 Character Cell file 

IFS/3000 Form file 

IFS/3000 Environment file 

IFS/3000 Compiled Character Cell file 

Graphics Image in RASTR Format 

OPT/ 3000 logfile 

TEPE/3000 Script file 

TEPE/3000 logfile 

APS/ 3 000 logfile 
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Integer Mnemonic Meaning 



1139 


MPEDL 


MPEDCP/DRP logfile 


1140 


TSR 


HPToolset Root file 


1141 


TSD 


HPToolset Data file 


1145 


DRAW 


Drawing File for HPDRAW 


1146 


FIG 


Figure File for HPDRAW 


1147 


FONT 


Reserved 


1148 


COLOR 


Reserved 


1149 


D48 


Reserved 


1152 


SLATE 


Compressed SLATE file 


1153 


SLATW 


Expanded SLATE workf ile 


1156 


DSTOR 


Store file for RAPID/ 3 000 Utility DICTDBU 


1157 


TCODE 


Code file for Transact/ 3000 Compiler 


1158 


RCODE 


Code file for Report/ 3 000 Compiler 


1159 


I CODE 


Code file for Inform/ 3 000 Compiler 


1166 


MDIST 


HPDESK Distribution list 


1167 


MTEXT 


HPDESK Text 


1168 


MAR PA 


ARPA Message file 


1169 


MARPD 


ARPA Distribution List 


1170 


MCMND 


HPDESK Abbreviated Commands file 


1171 


MFRTM 


Reserved 


1172 




Reserved 


1173 


MEFT 


Reserved 


1174 


MCRPT 


Reserved 


1175 


MSERL 


Reserved 


1176 


UCSF 


Reserved 


1177 


TTYPE 


Term Type file 


1178 


TVFC 


Term Vertical Format Control file 


1192 


NCONF 


Network Configuration file 


1193 


NTRAC 


Network Trace file 


1194 


NLOG 


Network logfile 


1195 


MIDAS 


Reserved 


1211 


ANODE 


Reserved 


1212 


I NODE 


Reserved 


1213 


INVRT 


Reserved 


1214 


EXCEP 


Reserved 


1215 


TAXON 


Reserved 


1216 


QUERF 


Reserved 


1217 


DOCDR 


Reserved 


1226 


VC 


VC file 


1227 


DIF 


DIF file 


1228 


LANGD 


Language Definition file 


1229 


CHARD 


Character Set Definition file 


1230 


MGCAT 


Formatted Application Message Catalog 


1236 


BMAP 


Reserved 


1242 


BDATA 


Basic Data file 


1243 


BFORM 


Basic Field Order File for VPLUS 


1244 


BSAVE 


Basic Saved Program file 


1245 


BCNFG 


Configuration File for Default Option Basic Program 


1246 


BKEY 


Function Key Definition file 
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I n t e ge r Mnemonic Meaning 



1258 
1259 
1270 

1271 



PFSTA 
PFDYN 
RTDCA 

FFDCA 



1272 


DIU 


1273 


PDOC 


1275 


DFI 


1276 


SRI 


1401 


CWPTX 


1421 


MAP 


1422 


GAL 


1425 


TTX 


1428 


RDIC 


1429 


RSPEC 


1430 


RSPCF 


1431 


REXEC 


1432 


RJOB 


1433 


ROUTI 


1434 


ROUTD 


1435 


PRINT 


1436 


RCONF 


1441 


PIF 


1461 


NMOBJ 


1462 


PAS LB 



Pathflow STATIC file 

Pathf low DYNAMIC file 

Revisable Form DCA Document 

(DCA = Document Content Architecture) 

Final Form DCA Document 

(DCA = Document Content Architecture) 

Document Interchange Unit file 

HPWORD/1 50 Document 

DISOSS Filing Information file 

Search Result Information file 

Reserved 

HPMAP/3000 Map Specification file 

Reserved 

Reserved 

HPBRW Dictionary file 

HPBRW Specification file 

HPBRW Specification file (frozen) 

HPBRW Execution file 

HPBRW Report Job file 

HPBRW Intermediate Report file 

HPBRW Dictionary Output file 

HPBRW Print file 

HPBRW Configuration file 

Reserved 

Native Mode Object file 

PASCAL Source Library 

Reserved 



Default is the unreserved file code of 0. 



numrec 



Using 1 090 (LOG) as your designated filecode may not yield the number of 
records you specify in the ;DISC= parameter. Most files use the number of 
records specified in the ;DISC= parameter as the maximum limit; user log- 
ging uses this specified number as a minimum. 

The maximum number of logical records in a new file. The theoretical 
maximum for fixed and undefined length records is 2,147,483,647. 
Since this maximum will be limited by block size, the actual maximum 
number of records per file is 2,097,120, which is based on 65535 sectors 
per extent and 32 extents. An approximate practical limit for numrec is 
2,097,119 for files with variable and undefined length records, and 
267 , 382 , 000 for fixed length files. The default is 1 023. 
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NOTE J 

The file system uses these values to compute other 
characteristics of the file as well. Therefore, the values 
(or default values) specified on the : BUILD command 
may be valid within their respective fields, but may 
cause overflow errors in the computation of internally 
needed file specifications. Refer to the MPE File System 
Reference Manual (30000-90236) for a discussion on 
calculating file space. 



numextents 



Maximum number of disc extents. 
8. 



This is a value from 1 to 32. Default is 



initialloc 



RIO or NORIO 



STD, MSG, or CIR 



Number of extents to be initially allocated to the file at the time it is 
opened. This is a value from 1 to 32. Default is 1. 

RIO creates a relative I/O file, which is a special file access method primari- 
ly used by COBOLII programs. You can, however, access these files from 
programs written in any language. Specifying RIO implicitly changes the 
record length parameter to F, or fixed record length. The default, NORIO, 
creates a non-relative I/O file. 

RIO and NORIO specifications affect only the physical characteristics of the 
file. If NOBUF is specified in the :FILE command, the file will be accessed 
in non-RIO mode; otherwise RIO access is used with RIO files. Special 
operations on RIO files, such as replicating a RIO file, uses NOBUF access. 
Refer to the MPE V Intrinsics Reference Manual (32033-90007) for a dis- 
cussion of relative I/O. 

Defines the type of file. The default, STD, is a standard MPE disc file. A 
MSG, or message, file allows communication between any set of processes in 
a first in, first out (FIFO) manner. Records are read from the start of the 
file and logically deleted and/or are appended to the end of the file. A 
CIR, or circular, file acts as a normal sequential file until full. When full, 
the first physical block is deleted when the next record is written, and 
remaining blocks are logically shifted to the front of the file. A circular 
file cannot be simultaneously accessed by readers and writers. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 
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OPERATION 

This command builds a new file on disc and immediately allocates space for it. If it is an ASCII file, the 
file space is initialized to blanks. If it is a binary file, the file space is initialized to zeros. 

Unless the TEMP parameter is specified, the file is saved in the permanent file domain. To create a per- 
manent file, you must have SF (Save Files) capability and SAVE access to the group to which the new file 
will belong. You can only build a file belonging to your logon account. 

If specified, the ";DEV=" parameter must be consistent with the group to which the new file will belong. 
If the group's home volume .set is not mounted, : BUILD will implicitly generate a volume set mount 
request. Refer to the MPE File System Reference Manual (30000-90236) for more information on file 
domains. 

The default characteristics of a file created with the : BUILD command are: fixed length records of 128 
words each, a blocking factor of 1, binary formatted, permanent file, a record limit of 1023, and a maxi- 
mum of 8 extents with 1 extent initially allocated. This is equivalent to entering: 

; BUILD _fiZe/7q/ne;REC=128,1,F,BINARY;DEV=DISC;DISC=1023,8,1 

EXAMPLES 

The following example creates a permanent disc filenamed WORKFILE, which can reside on any disc. 
WORKFILE has fixed length records of 80 bytes each. The records are blocked 3 records per block (which 
is the block] actor), and are written in ASCII code. The file has a maximum capacity of 2000 records 
divided into 1 extents with 2 extents allocated immediately. 

: BUILD WORKFILE;REC=-80,3,F,ASCII;DISC=2000,10,2 

The second example uses the : BUILD command to create a permanent disc file, named VFILE, belonging 
to the logon (default) group that resides on the volume set specified by VCLASS1: 

: BUILD VFILE;DISC=500,10,1;REC=-80 ; DEV= VC L ASS 1 

J 

Name of existing volume class 
The following example uses the CODE= parameter to create a logging file called NEWDATA: 
; BUILD NEWDATA;DISC=3000,1,1;CODE=LOG 

ADDITIONAL DISCUSSION 

MPE File System Reference Manual (30000-90236) 
MPE V Intrinsics Reference Manual (32033-90007) 
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:BYE 



Ends an interactive session. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session. It may not be used from a Job, Program, or in BREAK. It is 
not Breakable. 

OPERATION 

This command terminates a session and displays the CPU time used (in seconds), connect time (in minutes), 
the date and time, as follows: 

CPU=48. C0NNECT=35. FRI, MAY 4, 1985, 10:56 PM 

If you enter a : HELLO command before logging off, MPE terminates your current session and immediately 
initiates a new one. If you are logged onto the computer with a telephone connection, and you hang up 
before terminating your session, MPE issues a : BYE command automatically. 

EXAMPLE 

To terminate a session, enter: 
:BYE 
CPU=1. C0NNECT=5. FRI, MAY 4, 1985, 12:20 PM 
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:CACHECONTROL 



Tunes the performance of disc caching. Disc caching software is not included in the MPE Fundamental 
Operating Software and must be purchased separately. 



Syntax 



:CACHECONTROL [SEQUENTIAL=sc<7«ent»] [|RANDOM=rarteto/w?] [|BL0CKWRITE=5^ S }] 



PARAMETERS 

sequent n 



random? 



The number of sectors to be read from a sequential access disc file if the in- 
formation is not found in the cache. The disc read will stop at the extent 
boundaries and fetch at least the number or sectors requested. The number 
of sectors must be greater than 1, but less than 96 (inclusive). Default is 96 
sectors. 

The number of sectors to be read from a random access disc file if the in- 
formation is not found in the cache. The disc read stops at the extent 
boundaries and fetches at least the number of sectors requested. The num- 
ber of the sectors must be greater than 1, but less than or equal to 96. 
Default is 1 6 sectors. 



BLOCKONWRITE 



Specifies whether MPE will block the process until the posting of cache 
buffers to the disc is complete. The BLOCKONWRITE must be equal to YES or 
NO. Default is NO. 



USE 



This command may be issued from a Session, Job, or Program. It may not be issued in BREAK. 
Breakable. It requires System Supervisor (OP) or System Manager (SM) capability. 



It is not 



OPERATION 

The :CACHECONTR0L command tunes the performance of disc caching on your system. You must specify 
at least one keyword. Any combination of keywords can be used in a single command, but each can be 
used only once. They can be entered in any order. 

When an I/O read request fails to find data currently in memory (a read "miss"), the requested portion of 
the disc must be fetched into memory. Disc caching uses the information about the file extent size and ac- 
cess type (random or sequential) in its fetch strategy to maximize the "hit" ratio; that is, subsequent read 
requests may be satisfied by a disc domain fetched as a result of a miss. 
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The size of the fetch is limited by the extent size of the file. Within this limit, the size of the disc domain 
fetched will equal the greater of the following: 

• The requested size, or 

• The largest integer multiple of the requested size that is smaller than the value specified by the 
sequentn or randomn parameters. 

If the actual request is greater than the value for sequentn then caching will fetch the actual request size. 
If it is less than or equal to the value for sequentn, then caching will use the largest multiple of the 
requested size that is still less than the configured sequentn/ randomn value. A high hit ratio on read 
requests will help maximize disc caching performance. A poor choice of values for either or both of the 
sequentn and randomn parameters can substantially decrease the hit ratio. 

When disc caching is enabled on your system, data residing in the disc domain is transferred from the por- 
tion of memory reserved as the disc cache, and not from the disc itself. This way, I/Os complete at proces- 
sor speed, rather than at disc speed. 

When the I/O request is a write operation, physical posting to the disc will occur as a background task 
while the process continues. In this way, write requests appear completed to the user process before the 
disc has been updated. By specifying the BLOCKONWRITE=YES parameter, no user write requests will show 
complete until they are actually posted to the disc. This guarantees that the information is on disc when 
the request completes. However, the YES option it does eliminate one performance benefit that disc cach- 
ing normally provides: write operations will complete at disc access speed, rather than at processor speed. 

EXAMPLE 

To set the fetch values for random access files to 24-sector reads, and the value for sequential access files 
to 48, enter: 

: CACHECONTROL SEQUENTIAL=48,RANDOM=24 

In this example the default value of BLOCKONWRITE, which is NO, will be used. 
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.CHANGELOG 



Changes the user logging file without stopping or interrupting the logging process. 
available for G. 02. 00 and later releases of MPE V. 

SYNTAX 



This command is 



: CHANGELOG logid [§DEV=ctei>£ce] 



PARAMETERS 

logid 

device 



Name of the currently active use logging process. This name may contain 
from one to eight alphnumeric characters, beginning with an alphabetic 
character. 

Name of the device on which the new logging file is to be created. The 
device may be any one of the following: DISC, TAPE, SDISC, or CTAPE. 
Default is DISC. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It is 
available only to the creator of the logid and requires System Supervisor (OP) or User Logging (LG) 
capability. 

OPERATION 

This command permits the user to change the active logging file without stopping the logging process with 
the : LOG logid, STOP command. By specifying a device, you may switch the logging file from one device 
to another, regardless of the device on which the logging file was created. If you have enabled automatic 
logging with the : ALT LOG or : GET LOG command, however, the only device available for logging is the 
default, DISC. 

If the : CHANGELOG command is valid, the system writes a changelog record to the end of the current log- 
ging file and closes the file. It then opens a new logging file whose characteristics are identical to those of 
the preceding file and makes the new file permanent. If the system is unable to open a new file of the 
same size, it will try to open a new file half the size of the old file. If the system determines that the 
half -size file is too small to continue logging, user logging terminates. 

If the system opens a new logfile, it will immediately write a changelog record to the new file. The chan- 
gelog record posted to the old logging file contains the fully qualified identifier of the new logging file. A 
corresponding changelog written to the new file will contain the fully qualified identifier of the old log- 
ging file. Changelog records will also contain the device type of the logging file to which the changelog 
refers. 

The following messages will be displayed on the $STDLIST to confirm a successful change: 

Log file for logid AAA has been changed from A001.PUB.SYS to A002.PUB,SYS 
(ulogmsg 38) 



I 
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If the new logging file is a serial file, a message will appear on the Console advising the operator to mount 
the new log file: 

Mount new {tape/cartridge tape/serial disc} volume for logid (ulogmsg 40). 

When a user logging file is full, the system terminates the logging process and displays an appropriate 
message. 

However, by specifying the AUTO parameter in a : GET LOG or : ALT LOG command, you will enable an au- 
I tomatic CHANGELOG, thereby freeing yourself of the need to issue the :CHANGELOG command manually. 
The : AUTO parameter is available for G. 02. 00 and later releases of MPE V. Refer to the : ALTLOG and 
: GETLOG commands in this section. 

In order to use : CHANGELOG (manually or automatically), you must end the first user logging filename 
with the numeric characters "001" (e.g. fnameOOl). This establishes a naming convention that works in 
conjunction with the f ileset number to generate sequential filenames independently. New filenames will 
consist of the filename root (fname) plus the next sequential increment of the last three digits: 

Current File Next File 

TEST001 TEST002 

TEST002 TEST003 

• • • • • • 

TEST998 TEST999 

TEST999 TESTOO0 

The logging process opens files, and automatically names them with the next sequential number, up to a 
maximum of 999. Thereafter, the numbering sequence will reset to 000 and begin incrementing all over 
again. 

Automatic logging with the : CHANGE LOG command is available only for disc files. 



NOTE 



The logging process specified by logid must be currently ac- 
tive. If the logging process is in another state, such as 
RECOVERING, STOP, INTIALIZING, or if the loggging 
process has another : CHANGELOG pending, the command will 
terminate in an error state. The : ALTLOG command permits 
changing the logfile for an inactive logging process. 
: ALTLOG, however, does not provide a way to link logfiles 
into a set. 

ADDITIONAL DISCUSSION 

Refer to Section III, "Optional Capability" of the MPE V Intrinsics Manual (32033-90007) and the com- 
mands : LI ST LOG and :SHOWLOGSTATUS in this section. 
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:COBOL 



Compiles a COBOL program on the COBOL 68 compiler. COBOL is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 



SYNTAX 



:COBOL [textfile] \m[uslfile] [±] list file] \g[masterfile] ^neafile]] ]] 



PARAMETERS 

textfile 

uslfile 



listfile 



masterfile 



new file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is COBTEXT. 
Default is $STDIN. 

Actual file designator of the User Subprogram Library (USL) file to which 
the object program is written, which can be any binary output file with a 
file code of USL or 1024. Formal file designator is COBUSL. If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$OLDPASS. If entered, this parameter indicates that the file was created in 
one of four ways: 

• By saving, using the :SAVE command to save the default USL file 
$OLDPASS created during a previous compilation. 

• By building the USL with the Segmenter command -BUILDUSL. Refer 
the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file with the MPE : BUI LD command and 
specifying a file code of USL or 1 024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is GOBLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is COBMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if the textfile is not specified. 

Actual file designator of the file created by the textfile and masterfile. 
This can be any ASCII output file. Formal file designator is COBNEW. 
Default is that no file is written. 
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NOTE 

The formal file designators used in this command 
(COBTEXT, COBUSL, COBLIST, COBMAST, and COBNEW) 
cannot be backreferenced as literal file identifiers in the 
command parameter list. For further information, refer 
to the "Implicit :FILE Commands For Subsystems" discus- 
sion of the MPE : FI LE command. 

USE 

This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The : COBOL command compiles a COBOL source program into a USL file on disc. If you do not specify a 
source textfile, MPE expects input from your standard input device. If you create the USL file prior to 
compilation, you must specify a file code of USL or 1 024. If you do not specify a list file, MPE sends the 
program listing to your standard list device. 

EXAMPLE 

To compile a COBOL program from a file named SOURCE into an object program stored in the USL file 
$0LDPASS sending the listing to your standard list device, enter: 

: BUILD OBJECT_i_CODE=USL 



;COBOL SOURCE, OBJECT 

ADDITIONAL DISCUSSION 

COBOL/3000 Reference Manual (32213-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COBOLGO 



Compiles, prepares, and executes a COBOL program on the COBOL 68 compiler. COBOL is not part of 
the HP 3000 Fundamental Operating Software and must be purchased separately. 

SYNTAX 



:C0B0LG0 [textfile] MUstfile] U [masterfile] Mnewfile] ] ] 



PARAMETERS 

textfile 

list file 
masterfile 

newfile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is COBTEXT. 
Default is $STDIN. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal designator is COBLIST. Default 
is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is COBMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the file created by the merger textfile and master - 
file. This can be any ASCII output file. Formal file designator is COBNEW. 
Default is that no file is written. 



USE 



NOTE 



The formal file designators used in this command 
(COBTEXT, COBLIST, COBMAST, and COBNEW) cannot be 
backreferenced as actual file designators in the com- 
mand parameter list. For further information, refer to 
the "Implicit :FILE Commands For Subsystems" discus- 
sion of the MPE :FILE command. 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 
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OPERATION 

The :COBOLGO command compiles, prepares, and executes a COBOL program. If you do not specify 
textfile, MPE expects input from your standard input device. If you do not specify listfite, MPE sends the 
listing to your standard list device. 

The User Subprogram Library (USL) file created during compilation is a system defined temporary file 
$NEWPASS, which is passed directly to the Segmenter. The Segmenter writes the prepared program to 
SOLDPASS, which can then be executed. 

EXAMPLE 

To compile, prepare, and execute a COBOL program entered from your standard input device, with the 
program listing sent to your standard list device, enter: 

: COBOLGO 

To compile, prepare, and execute a COBOL program from the disc file TEXTFL and send the program list- 
ing to the disc file LISTFL, enter: 

t COBOLGO TEXTFL, LISTFL 

ADDITIONAL DISCUSSION 

COBOL/3000 Reference Manual (32213-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COBOLPREP 



Compiles and prepares a COBOL program on the COBOL 68 compiler. COBOL is not part of the HP 
3000 Fundamental Operating Software and must be purchased separately. 



SYNTAX 




PARAMETERS 

text file 
prog file 



list file 



masterfile 



neufile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is COBTEXT. 
Default is $STDIN. 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the MPE Segmenter creates the 
program file which will reside in the temporary file domain as $OLDPASS. 
The formal file designator is COBPROG. If you wish to create your own 
program file, you must do so in one of two ways: 

• By Using the MPE : BUI LD command, and specifying a file code of 1 029 
or PROG, and a numextents value of 1. This file is then used by the 
: PREP command. 

• Specifying a nonexistent file in the progfile parameter, thereby creat- 
ing a job file of the correct size and type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is COBLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is COBMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the merged textfile and masterfile. This can be 
any ASCII output file. Formal file designator is COBNEW. Default is that 
no file is written. 
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NOTE 

The formal file designators used in this command (COBTEXT, 
COBLIST, COBMAST, and COBNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information, refer to the "Implicit :FILE 
Commands For Subsystems" discussion of the MPE :FILE 
command. 

USE 

This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The :COBOLPREP command compiles and prepares a COBOL program creating a program file on disc. If 
you do not specify textfile, MPE expects the source program input from your standard input device. If 
you do not specify list file, MPE sends the output to your standard list device. 

You will get the best results by allowing the Segmenter to create your program file. You can, however, 
create your own permanent program file with the : BUILD command. When you do, you must specify a 
file code of "PROG" or "1029" and a numextents parameter of 1. The following BUILD command creates 
such a file, which is then used by the : PREP command: 

: BUILD PROGX;CODE=PROC;DISC=,1 

The USL file created during compilation is a system defined temporary file $OLDPASS, which is passed 
directly to the Segmenter. The Segmenter also uses the file $OLDPASS. The prepared program segments 
are written to it, thus overwriting any existing temporary file of that name. Therefore, although it is 
recommended that you use the default for prog file, if you decide that it is important to save the USL file 
created during the compilation process, you must create your own, permanent program file, referencing it 
in the : COBOL PREP command line. 

EXAMPLE 

To compile and prepare a COBOL program entered through your current input device with the listing 
printed on the current list device, enter: 

: COBOL PREP 



To compile and prepare a COBOL source program entered from the textfile SFILE into the program file 
MY PROG, sending the listing to your standard list device, enter: 

iCOBOLPREP SFILE, MYPROG 
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ADDITIONAL DISCUSSION 

COBOL/3000 Reference Manual (3221 3-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COBOLII 



Compiles a COBOLII program on the COBOL '74 compiler. COBOLII is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 



SYNTAX 



: COBOLII [textfile] [§ [uslfile) [ , [glistfile] [| [masterfile] [metafile] ] ] ] 
[%IHFO=quoteclstring] 
[§\l\<SP=ii>orkspacename] 



PARAMETERS 

textfile 

uslfile 



listfile 



masterfile 



new file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is COBTEXT. 
Default is $STDIN. 

Actual file designator of the User Subprogram Library (USL) on which the 
object program is written. This can be any binary output file with a file 
code of USL or 1 024. Its formal file designator is COBUSL. If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$0LDPASS. If the parameter is entered, it indicates that the file was 
created in one of four ways: 

• By using the :SAVE command to save, the default USL file created 
during a previous compilation. 

• By building the USL with the Segmenter command -BUILDUSL. (Refer 
to the MPE Segmenter Reference Manual (30000-9001 1).) 

• By creating a new USL file with the MPE : BUILD command and 
specifying a file code of US L or 1 024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is COBLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. The formal 
designator is COBMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the merged textfile and masterfile. This can be 
any ASCII output file. Formal file designator is COBNEW . Default is that 
no file is written. 
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quotedstring 



A sequence of ASCII characters bounded by a pair of single quotation 
marks (apostrophes) or by double quotation marks. You may use the 
delimiting character as part of the string so long as it appears twice. Any 
occurence of two single quotes in a row or two double quotes in a row, is 
considered part of the string, and, therefore, not the terminating delimiter. 



tforkspacename 



lUFO=quotedstring is used in the COBOLII programming language to pass 
compiler options to a program. These options will appear before the first 
line of source code in the text file. For detailed information, refer to the 
: RUN command in this section. 

Actual file designator of an HPToolset workspace used with HPToolset. 
The formal designator is COBWKSP . 



NOTE 



USE 



The formal file designators used in this command 
( COBTEXT , COBUSL , COBLIST , COBMAST , COBNEW , and 
COBWKSP ) cannot be backreferenced as actual file desig- 
nators in the command parameter list. For further informa- 
tion, refer to the "Implicit :FILE Commands For Subsystems" 
discussion of the MPE :FILE command. 



This command may be issued from a Session or a Job, but not in BREAK of from a Program. It is 
Breakable (suspends execution). 

OPERATION 

The : COBOL 1 1 command compiles a COBOLII program into a USL file on disc. If you do not specify 
textfile, COBOLII expects the source text to be entered from your standard input device. If you do not 
specify a listjile, COBOLII sends the program listing to the current list device. 

EXAMPLE 

To compile a COBOLII program stored in the file SOURCE into an object program on the USL file OBJECT 
and send the listing to the disc file LISTFL, enter: 

: BUI LP OBJECT ;CODE=USL 
: COBOLII SOURCE, OBJECT, LISTFL 

ADDITIONAL DISCUSSION 

COBOL/II 3000 Reference Manual (32233-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COBOLIIGO 



Compiles, prepares, and executes a COBOLII program on the COBOL '74 compiler. COBOLII is not part of 
the HP 3000 Fundamental Operating Software and must be purchased separately. 

SYNTAX 



:COBOLIIGO [text file] [g[listfile] L [masterfile] [Mneafile] ] ] 
IMlHFO-quotedstring] 
[|||WKS P=Dorkspacename ] 



PARAMETERS 

text file 

listfile 
masterfile 

new file 
quotedstring 



workspacename 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is 
COBTEXT . Default is $STDIN . 

Actual file designator of the file on which the program listing is written. 
This can be any ASCII output file. Formal file designator is COBLIST. 
Default is $STDLIST . 

Actual file designator of the master file which is merged against textfile to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is COBMAST . Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the merged textfile and the masterfile. This can 
be any ASCII output file. Formal file designator is COBNEW . Default is 
that no file is written. 

A sequence of ASCII characters bounded by a pair of single quotation 
marks (apostrophes) or by double quotation marks. You may use the 
delimiting character as part of the string so long as it appears twice. Any 
occurence of two single quotes in a row, or two double quotes in a row, is 
considered part of the string, and, therefore, not the terminating delimiter. 

lNFO=quotedstring is used in the COBOLII programming language to pass 
compiler options to a program. These options will appear before the first 
line of source code in the text file. For detailed information, refer to the 
: RUN command in this section. 

This parameter is the actual file designator of an HPToolset workspace. 
The formal file designator created by the compiler is COBWKSP . 
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NOTE 

The formal file designators used in this command 
( COBTEXT , COBLIST , COBMAST , COBNEW , and COBWKSP ) 
cannot be backreferenced as actual file designators in the 
command parameter list. For further information, refer to 
the "Implicit :FILE Commands For Subsystems" discussion of 
the MPE -.FILE command. 

USE 

This command may be issued from a Session or Job, but not in BREAK or from a Program. It is Breakable 
(suspends execution). 

OPERATION 

The :C0BOLIIGO command compiles, prepares, and executes a program using the COBOL 74 compiler. If 
you do not specify text f tie, COBOLII expects the source program to be entered from your standard input 
device. If you do not specify listfile, COBOLII sends the output to your standard list device. 

The USL file created during compilation is a system defined temporary file, $OLDPASS, which is passed 
directly to the Segmenter. The Segmenter purges the USL file and writes the prepared program to 
$OLDPASS if the progfile is omitted, which is then executed and may be executed repeatedly. 

EXAMPLE 

To compile, prepare, and execute a COBOLII program entered from your standard input device and send 
the program listing to your standard list device, enter: 

i COBOLIIGO 

To compile, prepare and execute a COBOLII program from the disc file TEXTFL and send the program list- 
ing to the disc file LISTFL , enter: 

i COBOLIIGO TEXTFL, LISTFL 

ADDITIONAL DISCUSSION 

COBOL/II Reference Manual (32233-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COBOLIIPREP 



Compiles and prepares a COBOLII program on the COBOL '74 compiler. COBOLH is not part of the HP 
3000 Fundamental Operating Software and must be purchased separately. 



SYNTAX 



:C0BOLIIPREP [text file] [^.[progfile] [|[iist/tie] [f[masterfile] \Mnewfile] ]] ] 
[ |§WKS P=tdorkspacename ] 
[§ltiFQ=quotedstririg] 



PARAMETERS 

text file 

prog file 



listfile 



masterfile 



neiofile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is 
COBTEXT . Default is $STDIN . 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the MPE Segmenter creates the 
program file, which will reside in the temporary file domain as $OLDPASS. 
Its formal file designator is COBPROG. If entered, this progfile indicates 
that a file was created in one of two ways: 

• By using the MPE : BUILD command and specifying a file code of 1 029 
or PROG, and a numextents value of 1. This file is then used by the 
: PREP command. 



• By specifying a nonexistent file in the progfile parameter, 
porary job file of the correct size and type is created. 



A tem- 



Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is COBLIST . 
Default is $STDL 1ST. 

Actual file designator of the file which is merged against textfile to produce 
a composite source. This can be any ASCII input file. Formal file desig- 
nator is COBMAST . Default is that the master file is not read; input is read 
from textfile, or from $STDLIST if textfile is not specified. 

Actual file designator of the file created by merging textfile and masterfile. 
This can be any ASCII output file. Formal file designator is COBNEW . 
Default is that no file is written. 
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quotedstring 



A sequence of ASCII characters bounded by a. pair of single quotation 
marks (apostrophes) or by double quotation marks. You may use the 
delimiting character as part of the string so long as it appears twice. Any 
occurence of two single quotes in a row, or two double quotes in a row, is 
considered part of the string, and, therefore, not the terminating delimiter. 

lHFO=quotedstring is used in the COBOLII programming language to pass 
compiler options to a program. These options will appear before the first 
line of source code in the text file. For detailed information, refer to the 
: RUN command in this section. 



tiorkspacename 



This parameter is the actual file designator of an HPToolset workspace used 
with HPToolset. The formal file designator created by the compiler is 
COBWKSP . 



NOTE 



USE 



The formal file designators used in this command 
(COBTEXT, COBLIST, COBMAST , COBNEW , and COBWKSP) 
cannot be backreferenced as actual file designators in the 
command parameter list. For further information, refer to 
the "Implicit :FILE Commands For Subsystems" discussion of 
the MPE :FILE command. 



This command may be issued from a Session or a Job, but not it BREAK or from a Program. It is 
Breakable (suspends execution). 

OPERATION 

The :COBOLIIPREP command compiles and prepares a COBOLII program into a program file on disc. If 
you do not specify textfile, COBOLII expects your input from your standard input device. If you do not 
specify listfile, COBOLII sends the listing output to your current list device. 

The USL file created during compilation is a system defined temporary file, $OLDPASS, which is passed 
directly to the Segmenter. The Segmenter overwrites the USL file and writes the prepared program to 
$OLDPASS if progfile is omitted, which can then be executed. 
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EXAMPLE 

To compile and prepare a COBOLII program entered from your standard input device with the listing 
printed on the standard list device, enter: 

; COBOLIIPREP 

To compile and prepare a COBOLII source program input from the text file SFILE into a program 
filenamed MY PROG , with the resulting listing sent to the current list device, enter: 

; COBOL 1 1 PREP SFILE, MY PROG 

ADDITIONAL DISCUSSION 

COBOL/II Reference Manual (32233-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:COMMENT 



Inserts a comment into the command stream. 



SYNTAX 



: COMMENT [text] 



PARAMETERS 

text 



Information composing the comment text. If the last nonblank character is 
an ampersand (&), comment text is continued onto the next line. Default is 
that a record containing only the string "COMMENT' is inserted in the com- 
mand stream. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The : COMMENT command allows you to include comments or notes in job listings produced on hard copy 
devices to create headings or explain the purpose of commands or logic used. After : COMMENT is entered, 
it can be followed by a message made up of any ASCII characters. 

EXAMPLE 

The following example of a job heading employs a comment: 

!JOB MAC. TECH PUBS 

! COMMENT -- THIS IS A SAMPLE JOB 

IFORTGO MY PROG 

!EOJ 
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:CONSOLE 



Changes the System Console from its current device to another job -accepting terminal. 

SYNTAX 



: CONSOLE [ldei>] 



PARAMETERS 

IdeO The logical device number of the new Console terminal. If omitted, the 

: CONSOLE command displays the current logical device number of the 
Console. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It may be used by any user to 
determine the location of the console. To change the location of the Console, it must be issued from the 
Console* or the user must have SM capability. 

* Also may be distributed to users with the : ALLOW command. 

OPERATION 

The : CONSOLE command has purposes: To display the logical device number of the terminal currently 
being used as the System Console, and to move the Console to another logical device. Listing the location 
of the Console requires no special capabilities. Moving the Console requires OP or SM capability. 

The Console cannot be moved to a remote terminal, i.e. one that is connected to your system via a 
Distributed Systems (DS) communications line. Similarly, it should not be moved to a terminal using a 
Multipoint Terminal Software (MTS) line, or a PAD terminal over a modem. 

When you switch the location of the Console with the : CONSOLE command, a message is printed on the 
former Console and on the logical device receiving the Console to display the new logical device number 
of the System Console. The old Console is now just another session device and all the Console capabilities 
are transferred to the newly designated terminal. 

Without parameters, the : CONSOLE command will report the current logical device number of the 
Console. No capabilities are required to execute the command this way. 
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NOTE 

Before transferring the System Console to another terminal, 
be sure that you can take the Console back when desired 
( :ALLOW user. account ;commands=CONSOLE ). Users as- 
signed System Manager (SM) capability can retrieve the 
Console without having been allowed the use of the 
: CONSOLE command. 



Since the System Console is a session device, a session must be logged on to the Console in order to execute 
Operator commands. 

Control and Maintenance Processor (CMP) and Diagnostic Control Unit (DCU) prompts and messages 
remain with the configured, e.g. Channel 1, Device 0. This feature cannot be moved to another 
terminal. 

EXAMPLE 

To determine the current location of the System Console, enter: 

; CONSOLE 

CONSOLE IS CURRENTLY ASSIGNED TO LDEV 20 

To transfer the Console to the terminal identified by MPE as logical device 31, enter: 

: CONSOLE 31 

CONSOLE HAS BEEN SWITCHED FROM LDEV 20 TO LDEV 31 
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rCONTINUE 



Overrides job error so that the job continues executing. 

SYNTAX 



: CONTINUE 



PARAMETERS 

None. 

USE 

This command may be issued in a Session, Job, or in a BREAK, but not from a Program. It is not 
Breakable. 

OPERATION 

The : CONTINUE command permits a job or session to continue even though the command immediately fol- 
lowing rCONTINUE results in an error (with accompanying error message). It is not needed in a session be- 
cause sessions do not terminate when a command error occurs. The rCONTINUE command is typically used 
in the line preceding any command suspected of causing the job to abort. If an error does occur, the job 
will continue to run, and the job output will contain the error message. 

EXAMPLE 

If you anticipate a possible error resulting from the command "RUN MY PROG", and wish to override this er- 
ror and allow the job to continue executing, enter: 

!JOB MAC. PUBS 
! CONTINUE 
♦RUN MY PROG 
!RUN MYPR0G2 
•EOJ 

ADDITIONAL DISCUSSION 

Refer to Section III of this manual. 
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:DATA 



Enters data into the system from any devicefile except $STDIN. 



SYNTAX 




PARAMETERS 

jsname 
username 

userpass 
aootname 

acotpass 
filename 



Name of job or session that is to read data. Default is no job/session name. 

User name that allows you to access MPE under this account, as established 
by the Account Manager. 

User password, optionally assigned by the Account Manager. 

Account name under which job/session is running, as established by the 
System Manager. 

Account password, optionally assigned by System Manager. 

Additional qualifying name for the data that can be used by a job or session 
to access data. It may be used to distinguish two separate data decks read 
from different card readers by the same program. Default is that no dis- 
tinguishing name is assigned. 

Note that the jsname, username, userpass, acctname, acctpass, and filename parameters all are names that 
contain as many as eight alphanumeric characters, beginning with an alphabetic. 

USE 

This command may be issued from a Session or Job, but may not come from $STDIN. It may not be used 
from a Program or in BREAK. It is not Breakable. 

OPERATION 

This command identifies input that is to be read from a devicefile other than the standard input device. 
The :DATA command would be used to read a file from a spooled input device while running an interac- 
tive session. However, if the : DATA command is entered from the terminal during a session, it makes the 
terminal a data file for some unspecified process, which prevents you from using it until a process issues a 
request for data from the terminal. 
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The : DATA command is the only command that can be entered before a job or session is initiated with the 
: JOB or : HELLO commands. Files identified by :DATA may be input on cards, magnetic tape, paper tape, 
or from a terminal. To designate a set of data as an auxiliary file for a job or session, enter the : DATA 
command followed by the data deck or file, and the : EOD command. Begin the job or session using the 
same identity ( [jsname , ] user name .acctname), used in the : DATA command so that the data can be used 
by the job or session. If the filename parameter is omitted, several data decks or files can be read from 
any job or session with the same identity. 

The : STREAM command must be used to submit data from a disc file. When data is entered from mag- 
netic tape, the file must reside on a single tape volume, with a blocking factor of 1. When the media con- 
taining the data file is placed on the input device and that device is placed online, MPE reads the entire 
file if the input device is spooled. Only the : DATA command is read if the file is input from a nonspooled 
device. At that point, the job can access the data, which remains available until it is actually read. 

EXAMPLE 

A session is running and is identified by the session name SESSA, username BROWN, and account name 
ACCT 1 . Data on punched cards needs to be made available to that session, to be used by a program named 
PROGY. This program references the data under the formal file designator DATAFL. Proceed as follows: 

1. Arrange the data deck beginning with the :DATA command and terminating with the :EOD com- 
mand, as follows: 

: DATA SESSA , BROWN . ACCT 1 



data 



:EOD 

2. Load the cards into the card reader and make the reader READY. If the card reader is a spooled 
device, the data is copied to disc, where it awaits access. If it is not a spooled device, the :DATA 
command is read, but the subsequent data remains in the card reader until the program accesses it. 
The : DATA command is used to build an entry in the device directory that identifies the file to the 
system. 

3. Begin your session, making sure to use precisely the same session identity you entered in the : DATA 
command. (For instance, if the optional session name is omitted SESSA the session will not be able 
to access the data. ) To logon, enter: 

: HELLO S ESS A, BROWN. ACCT 1 

4. Enter a : FILE command equating the formal file designator DATAFL (used by the program PROGY) 
with the card reader. For example: 

: FILE DATAFL ;DEV=CARD 

5. Run the program that requires the data; when the program attempts to open the file DATAFL, it will 
be available: 

:RUN PROGY 
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If the data has not been entered through the card reader before this step, the program transmits a 
message to the System Operator requesting this data and waits for it to become available. It is then 
the System Operator's option whether to supply the data via the : DATA command or, if the data is 
not available, to send a message asking you to supply it, or abort the session. 

6. Once the data has been read, it is no longer available to the system. If another program requires this 
data, the data must be entered again. 

In the next example, a data file is created on disc and the : STREAM command is used to make the file 
available to your program: 

1. Create the file DATAFL on disc beginning with the :DATA command and ending with the :EOD 
command. 

: DATA SESSB , BROWN . ACCT1 



data 

:EOD 

2. Stream the data file, using the : STREAM command as follows: 

: STREAM DATAFL 

3. Log onto a session, making sure that precisely the same session identity is used as was entered in the 
: DATA command: 

: HELLO SESSB, BROWN. ACCT1 

4. Enter a : FILE command equating the formal file designator (used by the program) with the streams 
device (identified by the device class name JOBTAPE): 

; FILE DATAFL ;DEV=JOBTAPE 

5. Run the program that requires the data: 

:RUN PROGY 
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:DEALLOCATE 



Deallocates a program or procedure previously loaded into memory with the : ALLOCATE command. 

SYNTAX 



nrAi.^-rir [PROGRAM;! ] 
DEALLOCATE \ PR0CEDlJRE ^me 



PARAMETERS 

PROGRAM 
PROCEDURE 

name 



The program file indicated by name is deallocated. Default. 

The code segment containing the procedure specified by name in 
SL . PUB . SYS is deallocated. Default is PROGRAM. 

The name of the program file or procedure to be deallocated. 



USE 

I This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. Any auto- 
allocated program for which a user has EXECUTE access can be deallocated. A user with OP capability 
can deallocate any program. 

OPERATION 

: DEALLOCATE will immediately release table entries belonging to a program file or procedure that has 
been allocated. If the program is currently executing, the command will take effect once the program or 
procedure is no longer in use. 

EXAMPLE 

To deallocate a program filenamed PROGEX, enter: 
: DEALLOCATE PROGEX 
: DEALLOCATE does not give back memory, it gives back table entries. 
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:DEBUG 



Invokes the MPE Debug Facility. 

SYNTAX 



: DEBUG 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Program, or in BREAK. It may not be issued from a Job. It 
is not Breakable. A user must have Privilege Mode (PM) capability to use this command. 

OPERATION 

The : DEBUG command, which can only be executed by a user with Privileged Mode (PM) capability, is an 
extension of the MPE Debug Facility. It is used primarily by systems programmers to analyze code and 
trace errors in program logic. : DEBUG is fully explained in the MPE Debug/Stack Dump Reference 
Manual (30000-90012). 



CAUTION 



The normal checks and limitations that apply to standard 
MPE users are bypassed in Privileged Mode. It is possible for 
a Privileged Mode user to destroy the integrity of the system, 
including MPE operating system software itself. 
Hewlett-Packard will investigate and attempt to resolve the 
problems resulting from the use of Privileged Mode code. 
This service, which is not provided under the standard 
Service Contract, is available on a time and materials billing 
basis. However, Hewlett-Packard will not support, correct, 
or attend to any modification of the MPE operating system 
software. 
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:DELETESPOOLFILE 



Deletes a spoolf ile from disc. 

SYNTAX 



{iOnnn} 

: DELETES POOLFILE {ilnrtn} 

{Ideo ) 



PARAMETERS 

iOnnn The identification of a READY or ACTIVE output spoolfile. 

Hnrm The identification of a READY, input spooled : DATA file. 

IdeV The logical device number on which the spoolfile is ACTIVE. 

USE 

This command may be issued from a Session, Program, or in BREAK. It may not be issued from a Job. It 
is not Breakable. This command may be used only from the Console. * 

• Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

Before deleting an ACTIVE spoolfile, you should first take the output device offline. This allows you 
time to enter the command and determine that the ACTIVE spoolfile corresponds to the correct output 
device. When MPE returns the colon prompt (: ), you know that the rDELETESPOOLFILE instruction has 
been sent to the spooler process. It will not be executed, however, until the output device is put back 
online. 

You may not use the rDELETESPOOLFILE command on the following files: 

• System defined standard input spoolf i!es($STDIN ). Delete them with the : ABORT JOB command. 

• ACTIVE spoolf iles with rDATA input, entered via the : STREAM command. You may delete these only 
when they are READY. You may also not delete these files when they are OPEN. 

rDELETESPOOLFILE will delete ACTIVE :DATA input files which are submitted on a spooled device, such 
as a card reader. It cannot delete such files while they are being : STREAMED 
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EXAMPLE 

To delete the ACTIVE spoolfile being printed on Idev 6, first take the printer offline. This generates a 
"NOT READY" message at the Console, after which you may enter the :DELETESPOOLFILE command, as 
shown below: 

11:21/7/LDEV#6 NOT READY 
; DELETESPOOLFILE 6 

When you put the device back online, the trailer page will be printed, and the file deleted. If you have 
suppressed header/trailer output with the : HEADOFF command, no trailer is printed before the spoolfile is 
deleted. However, the printer will skip to the top of the next physical page. If the device is a page print- 
er, the default environment is reloaded. 
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:DISALLOW 



Prohibits access to a specific Operator command. 

SYNTAX 



: DISALLOW FI LE=formaldesignator [pHOW] 



{ e.e 



> 



:DISALLOW 



{ user.% }~ : . 
{ %.acct } s 
{ user. ace t } 



C(M^AHDS=command[mconrnandM. . • ] 



PARAMETERS 

formaldesignator 

SHOW 

e.e 

user.% 
%.acct 
user.acct 



A formal ASCII filename, which may consist of as many as eight al- 
phanumeric characters, beginning with a an alphabetic character. 

Lists input lines on $STDLIST . 

Prohibits access to all users whether logged on or not. 

Prohibits access to a specific user in all accounts. 

Prohibits access to all users in a specific account. 

Prohibits access to a specific user in a specific account. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. This com- 
mand may be used only from the Console. * 

* Unless distributed to users with the : ALLOW command. 
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OPERATION 

The Operator uses the : DISALLOW command to prohibit a user from executing specific console commands 
previously allowed with the : ALLOW command. One form of the command requires you to enter the list 
of prohibited commands directly at the console. The second form of : DISALLOW is the indirect mode, in 
which you use EDIT/ 3 000 create a file with EDIT/ 3 000 that contains the username and account of those 
users who will be prohibited from executing certain Operator commands, and a list of disallowed com- 
mands. The procedure is similar to the following example: 

: EDITOR 

HP32201A.7.16 EDIT/3000 TUE, MAY 29, 1984, 5:08 PM 

(C) HEWLETT-PACKARD CO. 1984 

/ ADD 

1 SUSAN . PAYROLL ; COMMANDS=ALTJOB , ALTSPOOLFI LE 

2 JOHN . ACCTNG; COMMANDS=ALTSPOOLFI LE , DELETESPOOLFI LE 

3 ZZ 

/ KEEP COMNDTMP 
/£ 

Once this file is defined, command input is taken from it rather than from data entered at the console. 
No continued records are permitted. The : DISALLOW command is then executed by entering the 
following: 

: DISALLOW FILE=COMNDTMP;SHOW 

The ;SHOW parameter directs MPE to display each command line as it is executed from the file. 

A third form of the command is the subsystem mode. In this case, you need only type the command name, 
: DISALLOW , followed by a [RETURNI . You will then be prompted with a "> ", after which you enter com- 
mand parameters. Subsystem mode ends when an EOF is received, or until you EXIT . 

EXAMPLE 

To prohibit the user MAC. TECH from executing the : REPLY and :ABORTIO commands, enter the follow- 
ing on the System Console: 

; DISALLOW MAC. TECH ;COMMANDS=REPLY , ABORTIO 

To use subsystem mode to prohibit the user MGR. MANUALS from executing the : BREAK JOB command, en- 
ter the following on the System Console: 

: DISALLOW 

> MOR. MANUALS ;COMMANDS=BREAKJOB 

>EXIT 
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:DISASSOCIATE 

Removes control of a device from the user. 

SYNTAX 



: DISASSOCIATE deOclass 



PARAMETERS 

deOclass The name of a device class configured during SYSDUMP. 

USE 

This command may be issued from a Session, Program, or in BREAK. It is not Breakable. 

OPERATION 

This command negates a previously issued : ASSOCIATE command by removing control of a device class 
from a user. The command may be issued by the System Operator or by the user. The user implicitly dis- 
associates a device when logging off. 

EXAMPLE 

To terminate control of the device class "TAPE", enter: 
: DISASSOCIATE TAPE 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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:DISCRPS 

Enables or disables the Rotational Position Sensing (RPS) feature on a specified logical device. RPS is 
supported only on G. 00. 00 and later releases of the operating system. It requires a special firmware up- 
grade to CS-80 disc drives. 

SYNTAX 



HTcrRDc M*„ (IENABLE > 
:DISCRPS Ideo { , DISABLE} 



PARAMETERS 

IdeO The logical device number of the specified CS-80 disc drive. 

ENABLE Enables Rotational Position Sensing on the device. 

DISABLE Disables Rotational Position Sensing on the device. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be executed only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOC I ATE commands. 

OPERATION 

The :DISCRPS command allows you to enable or disable the Rotational Position Sensing feature for 
CS-80 disc drives. With RPS enabled, the disc drive signals its availability to do an I/O only when it is a 
small rotational distance away from the target data. This improves system performance when more than 
one drive is connected to the same HP-IB channel. 

EXAMPLE 

To enable the RPS feature on logical device 1 and display the drive's status, enter: 

; DISCRPS 1, ENABLE 

: SH0WDEV 1 

LDEV AVAIL OWNERSHIP VOID DEN ASSOCIATION 

1 DISC (RPS) 50 FILES 
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.DISMOUNT 



Causes a volume set that was explicitly mounted by the user to be dismounted. 



SYNTAX 



: DISMOUNT [j 0c * n(me \ [.groupname[.acctname\]\ 



PARAMETERS 



* or Vcsname 



groupname . acctname 



USE 



Specifies the volume set. The asterisk (*) specifies the home volume set for 
the group and account specified, or the logon group and account if they are 
not specified. The vcsname parameter specifies the volume set/class name 
of a previously defined volume set name or volume class name. Omitting 
this parameter is equivalent to *. 



Specifies the group and account which created the volume set. 
the logon group and account. 



Default is 



This command may be issued from a Session, Job, or in BREAK, 
not Breakable. 



It may not be used from a program. It is 



OPERATION 

The : DISMOUNT command allows you to dismount a volume set that you explicitly mounted using the 
: MOUNT command. If there are no other users of the volume set, the devices on which it resides are made 
available to the system. You can request a dismount only for a volume set that you have mounted; you 
cannot alter the status of the volume set for other users. 

EXAMPLE 

To dismount the volume set MYSET, previously mounted by you via a : MOUNT command, enter: 
: DISMOUNT MYSET 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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:DOWN 



Removes a device from normal system use. 

SYNTAX 



:DOWN Ideo 



PARAMETERS 

Ideif The logical device number of the device being taken offline. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
used only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

When you issue the :DOWN command for a device that is in use, the request will be satisfied when the 
process currently accessing it releases it. 

Once you :DOWN a device corresponding to the master volume of a Nonsystem Domain disc drive, MPE 
will reject all further requests to use any volume in the set to which the master volume belongs. 

The system console cannot be downed. Any attempt to do so will result in the following error message: 

DOWN NOT PERFORMED ON CONSOLE DEVICE (CIERR 3150) 



CAUTION 



When any device is powered down without the use of the 
: DOWN command, subsequent access to that device can result 
in indefinite waiting, erroneous transfers, or other incorrect 
operation. Often these failures will occur with no 
indication to the System Operator or to the user. For this 
reason, it is very important that every device which is not 
fully operational (especially those which are powered down) 
be downed with the : DOWN command. A device that will be 
inoperable for more than a few hours can be temporarily 
removed from the I/O configuration at system start up. 
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EXAMPLE 

To take logical device number 7 offline, enter: 

: DOWN 7 

To take logical device number 1 (an input spooled, job accepting magnetic tape) offline, enter: 

: DOWN 10 

: STOPS POOL 10 

1 1 : 16/31 /SP#10/STOPPED 

11: 16/31 /LDEV#10 NOT READY 
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DOWNLOAD 



Downloads format information to a line printer. 

SYNTAX 



•DOWNLOAD Ideo Uf ilename 1 rn i 

.download taeo rpARGIN=ww ] l a ...J 



PARAMETERS 

Ideo 

filename 
nn 



The logical device number of the output device. This device must be a HP 
2608 or HP 2563 line printer. (The HP2563 printer is supported only on 
the G. 00. 00 and later releases of MPE V.) 

The fully qualified name of a file containing the download control 
information. 

The print position that the first byte of data will assume. This number can 
be between 1 and 16, inclusive. Note that the HP 2608 Hardware 
documentation discusses a margin offset which varies from 0-15. This 
offset is not relevant to the margin parameter of the : DOWNLOAD command, 
as the software compensates for the hardware offset of nn - 1 . 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOC I ATE commands. 

OPERATION 

The Operator uses the : DOWN LOAD command to transmit format information to system printers only. It 
cannot be used with remote printers. 

The Vertical Format Control (VFC) image file (filename) can define the margin setting as well as the VFC 
image on an HP 260 8 A or HP 2608S line printer. The number of print lines per form is limited to 127. 
Although the HP 2608S printer recognizes the : DOWN LOAD command, Hewlett-Packard recommends con- 
trolling the HP 260 8S with an environment file rather than the : DOWNLOAD command. You cannot 
download a VFC file to HP 263 IB printer, only the MARGIN =nn is allowed. (For a discussion of special 
hardware considerations, refer to Section VIII of the MPE System Operation and Resource Management 
Manual (32033-90005). 
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If the MARGIN=nn parameter is specified on an HP 2608A or HP 2608S, and a MARGIN record has also 
been specified in the VFC file, the MARGIN record in the VFC file overrides the MARGIN parameter of the 
: DOWNLOAD command. This parameter should only be used in cases where there is no MARGIN record in 
the VFC file. 

When a particular print job has requirements for forms and/or a VFC file, the user will indicate this need 
via a FORMS message. (Refer to "EXAMPLE".) 



CAUTION 



Do Not Issue a : Down load Command to an HP 2608S 
White a Spool File is Active. This will make the device 
UNAVAILABLE, and it will remain so until the system is 
restarted with a WARMSTART. 

EXAMPLE 

To respond to a forms message, enter: 

I0/15:46/22/F0RMS: PLEASE MOUNT PAYCHECK FORMS. USE VFC=VFCPAY 
IO/15:46/22/SP#11/LDEV# FOR #S93;OUTFILE ON HP 2608 (1) 

: DOWNLOAD 11, VFC PAY 

To reset the VFC to its original state, you must reference a file that contains default specifications (such 
as VFC6 in this example) by entering: 

: DOWNLOAD 1 1 .VFC6.PUB.SYS 

To set the left margin print position to column 4 (the installation defined default) enter: 

: DOWN LOAD 11, MARGINS 
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DSTAT 



Displays the current status of the disc drives on the system. 



SYNTAX 




PARAMETERS 

Ideo 
ALL 



An integer specifying the logical device number of the disc drive whose 
status is desired. 

Displays the status of all disc drives, both system and non system. The 
default is that if no parameter is included, only the status of non system 
discs is displayed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The : DSTAT command is used to display the current status of one or more disc drives on the system. For 
example: 



: DSTAT ALL 



LDEV-TYPE 



STATUS 



VOLUME (VOLUME SET-GEN) 



1-7933/7935 


SYSTEM 


MARKET 1 


2-7920 


SYSTEM 


MARKET2 


3-7905(R) 


AVAIL 


(USERVOL1.PUB.SYS-0) 


4-7920 


DOWNED 




5-7920 


AVAIL 


(SLAV0L1.PUB.SYS-0) 


1 1 -7920 


AVAIL 


(SLAVOL2.PUB.SYS-0) 


12-7920 


AVAIL 


(SLAV0L3.PUB.SYS-0) 
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The status can be: 

STATUS 

AVAIL 

AVAIL "SCRATCH* 

DOWNED 
FOREIGN 

MOUNTED 
OFF LINE 
SYSTEM 
SERIAL 
DOWN-PND 

RESERVED 



MEANING 

A non system disc is physically mounted, but is not being used. 

A non system disc has one bit modified in the disc label, so that it cannot be 
used. You can use the VINIT subsystem to reset this bit. The disc then as- 
sumes its former state (either serial disc or Private Volume). 

The disc is not available for use. 

The disc is unformatted or contains data in a form not recognizable by 
MPE. 

The disc is mounted and currently is being accessed. 

The disc is spun down. 

The disc is allocated to the operating system. 

This is a serial disc. 

A : DOWN command has been issued for this disc to make it unavailable for 
use. However, since the disc was still in use when the command was issued, 
the : DOWN is pending completion. 

A non system disc has been reserved for use by a process. 



EXAMPLE 

To display the status of LDEV 7 enter 
: DSTAT 7 

LDEV-TYPE STATUS 

7-7902 FOREIGN 



VOLUME (VOLUME SET-GEN) 
•UNALLOCATED* 



ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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:EDITOR 



Runs EDIT/3000 

SYNTAX 



: EDITOR [list file] 



PARAMETERS 

list file Actual file designator of file to receive any output resulting from 

EDIT/3000 commands LIST and XPLAIN when the OFFLINE option is 
specified. It can be any ASCII output file. The formal file designator and 
default is EDTLIST. If specified with no device parameter, default device is 
LP. 



NOTE 



The formal file designator used in this command (EDTLIST) 
cannot be backreferenced as an actual file designator in the 
command parameter list. For further information, refer to 
the "Implicit :FILE Commands For Subsystems" discussion of 
the MPE :FILE command in this section. 

USE 

This command may be issued from a Session or Job. It may not be used from a program or in 
BREAK. It is Breakable (suspends execution). 

OPERATION 

The : EDITOR command runs the EDIT/3000 subsystem. 

EXAMPLE 

To runs EDIT/3000 during a session and specify a line printer (device class LP) as the list device for off- 
line output, enter: 

: FILE LISTFILE;DEV=LP 
: EDITOR "LISTFILE 

Because the list file is often a line printer, it is often defined in an MPE : FILE command and backreferen- 
ced as in the preceding example. 
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ADDITIONAL DISCUSSION 

EDIT/3000 Reference Manual (03000-90012) 
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Provides an alternate execution sequence for an : IF statement. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, or in BREAK. It may not be used from a Program. It is 
not Breakable. 

OPERATION 

The :ELSE command is used only in conjunction with the :IF command. The :IF command is used with 
the :ENDIF command, and optionally with the :ELSE command, to control the execution of a job. The 
: IF, : ENDIF, and optional : ELSE commands constitute an IF block. A logical expression is evaluated, and 
if true, the IF block is executed; if false, the ELSE block (if one exists) is executed. 

EXAMPLE 

The following job listing illustrates use of : ELSE command: 

! CONTINUE 

!SPL MYPROG,MYUSL 

!IF JCW>=FATAL THEN 

! TELL MAC. TECH PUBS; COMPILE FAILED 

!ELSE 

! TELL MAC. TECH PUBS; COMPILE COMPLETED 

! ENDIF 

For more information on Job Control Words (JCWs), refer to : SETJCW and : SHOWJCW in this section. 
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:ENDIF 



Terminates an IF block. 



SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, or in BREAK. It may not be used from a Program. It is 
not Breakable. 

OPERATION 

The :ENDIF command is used to terminate an IF block. The : IF command, the optional :ELSE com- 
mand, and :ENDIF command constitute an IF block. They are used to control the execution of a job. A 
logical expression is evaluated, and if true, the IF block is executed; if false, the : ELSE block (if one exists) 
is executed. The example on the preceding page illustrates how this command may be used. 
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:EOD 



Denotes end-of -data on input stream and terminates a set of data initialized by the : DATA command. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session or a Job. It may not be used from a Program or in BREAK. 
It is not Breakable. 

OPERATION 

The : EOD command is used to signify the end of a data set entered through a standard input device. It is 
also used to delimit data entered via the : DATA command submitted on data accepting devices such as tape 
drives and card readers. 

In most cases, programmers use : EOD for delimiting data. Any record beginning with a colon, however, 
will delimit data. Using a command other than : EOD for this purpose depends upon whether the standard 
input file is opened with the filename $STDIN or $STDINX. Refer to Table 2-4 on the following page to 
see which delimiters are permitted with which files. If you enter certain end-of -file indicators such as 
: EOD or : : EOF : interactively while using MPE or from a subsystem, you may terminate your session. 

When using a compiler language that does not provide a convention for terminating compilation (such as 
END in SPL), you must enter : EOD after the last record of your source program to ensure proper delimiting 
of your input. The : EOD command is not required when using the BASIC interpreter since the subsystem 
provides different conventions for delimiting data. 

The : EOD command causes the FREAD intrinsic to return the CCG condition code to the calling program, 
which indicates the end-of -file condition on the terminal. 
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Table 2-4. End-of-File Indicators 



TYPE OF FILE 


INDICATORS 


DATA file from 
Standard Input Device 
(for sessions) 


: EOD Terminates $STDI N and $STDI NX. 
::EOF: 

: followed by any 
other character Terminates $STDI N. 


DATA file from 
Standard Input Device 
(for jobs) 


:EOJ 

:JOB Terminates $STDIN. 

:EOD 

:DATA 

: EOD Terminates $STDINX. 
::EOF: 

: followed by any Terminates $STDIN. This record is then inter- 
other character preted by the Command Interpreter as the next 
command to be executed. 


: DATA files 


:EOD 
:JOB 
:DATA 
::EOF: 



EXAMPLE 

To terminate a data file entered on cards for a session identified as SESS1 , BLACK. ACCTSP, your data 
deck would contain : EOD as last record. Enter: 

:DATA SESS1 , BLACK. ACCTSP 



data 



:EOD 

The following FORTRAN program is an example of how the : EOD command is used to terminate a data 
set data entered through a standard input device: 



2-116 



: FORTRAN 

PAGE 0001 HP32102B.01.04 (C) HEWLETT-PACKARD CO. 1985 



>$CONTROL USLINIT 

> PROGRAM MONEY 

> INTEGER QUARTERS, DIMES, NICKELS, PENNIES 

> DISPLAY "INPUT MONEY AMOUNT IN DECIMA~ FORM " 

> ACCEPT DECIMALFORM 

> CALL CHANGER(DECIMALFORM, QUARTERS, DIMES, NICKELS, PENNIES) 

> DISPLAY QUARTERS," QUARTERS'" 7 

> DISPLAY DIMES," DIMES" 

> DISPLAY NICKELS," NICKELS" 

> DISPLAY PENNIES," PENNIES'*" 

> STOP 

> END 



program unit money compiled 

> subroutine changer (decimalform quarters, dimes, nickels, pennies) 

> integer quarters, dimes, nickels, pennies 

> decimalform = decimalform* 100 

> quarters = decimalform/25 

> remainder = decimalform- (quarters«25) 

> dimes=remainder/10 

> remainder=remainder-(dimes«10) 

> nickels=remainder/5 

> pennies=remainder"-Tnickels«5) 

> RETURN 

> END 



PROGRAM UNIT CHANGER COMPILED 
>:EOD 



###* GLOBAL STATISTICS **** 
**** NO ERRORS, NO WARNINGS ***» 
TOTAL COMPILATION TIME 0:00:01 
TOTAL ELAPSED TIME 0:01:29 



END OF COMPILE 
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::EOF: 



Simulates physical end -of -file on input stream from any device. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is not Breakable. 

OPERATION 

This command denotes the end-of-file when read through an input stream. It is required to simulate a 
physical end-of-file on HP 2894A Card Reader/Punch when that device is configured to refuse data 
submitted via a :DATA command. (This device does not provide a true hardware end-of-file indication.) 
Note that use of this command interactively will terminate your session. 

EXAMPLE 

To denote the end-of-file read through an input stream, enter: 
| : ; EOF : (The last colon in this command must be followed by a blank or [RETURN! . ) 

ADDITIONAL DISCUSSION 

For more information on end-of-file indicators refer to the : EOD command in this section. 
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:EOJ 



Ends a batch job. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Job. It may not be used from a Session, Program or in BREAK. It is 
not Breakable. 

OPERATION 

The : EOJ command terminates a batch job and displays the CPU time (in seconds) and the elapsed time 
since the beginning of the job (rounded to the nearest minute) to be displayed. MPE also adds the central 
processor time and file space used by your job to the resource usage counters maintained for your logon 
account and group. 

If you omit the :EOJ command from a job, the next : JOB command terminates the current job and starts 
a new one. The end of the first job is indicated by the standard end-of-job display, and the beginning of 
the next job is denoted by the normal job initiation display. 

EXAMPLE 

The following example shows how : EOJ is used within a job file to terminate a batch job: 

!JOB MAC. PUBS 
•RUN MY PROG 1 
!RUN MYPROG2 
!EOJ 
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:FCOPY 

Runs the FCOPY subsystem. 

SYNTAX 



: FCOPY [fcopycommand] 



PARAMETERS 

fcopycommnd An FCOPY/3000 subsystem command. The FCOPY/3000 subsystem en- 

ables you to copy files or selected portions of files from any supported input 
device to any supported output device. There are many commands; only 
the most common examples will be found in the "EXAMPLE" section of this 
command. Refer to the FCOPY Reference Manual (03000-90064) for 
more information. 

USE 

This command may be issued from a Session or a Job. It may not be used from a Program or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

This command runs the FCOPY subsystem from MPE. If the command is entered with no parameters, 
: FCOPY prompts ( >) the user for subsystem commands until an EXIT command is entered. If the 
fcopycommand parameter is used, : FCOPY executes the FCOPY subsystem command and then returns con- 
trol to MPE. 

EXAMPLE 

To access the FCOPY subsystem to execute multiple commands, enter: 

; FCOPY 

HP32212A.3.12 FILE COPIER (C) HEWLETT-PACKARD CO. 1985 

> ** FCOPY subsystem prompt character. ** 
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To access FCOPY to execute a single command and return control to MPE, enter the command as follows: 
: FCOPY FROM=UDC . TECH PU BS ; TO=TEMP ; N EW 
HP32212A.3.19FILE COPIER @ HEWLETT-PACKARD CO., 1984. 
EOF FOUND IN FROMFILE AFTER RECORD 23 
24 RECORDS PROCESSED *** ERRORS 

END OF SUBSYSTEM 

ADDITIONAL DISCUSSION 

FCOPY Reference Manual (03000-90064) 
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:FILE 



Declares the file attributes to be used when a file is opened. This declaration, informally known as a file 
equation, may be used to override programmatic or system default file specifications. With the addition 
of shared parameters from the NS/3000 AdvanceNet or the DS/3000 subsystem, the declaration may 
specify a formal file designator that may be used to access a remote file or device in a subsequent com- 
mand or intrinsic. NS/3000 AdvanceNet and DS/3000 are not part of the HP 3000 Fundamental 
Operating System and must be purchased separately. 



SYNTAX 



FILE formaldesignator" 



=*formaldesignator 

=$NULL 

=$NEWPASS 

=$OLDPASS 

=$STDIN 

=$STDINX 

=$STDLIST 

=filereference [ : nodespeo] [Mfiledomain] 



[|DEV=[ [en»name]#] [device] \j§outpri] [§numcopies] ] 

[,?VTERM] 

[ iENV=enufile[§nodespec] ] 

[ioption] 

I \access] 

[^disposition] 



formaldesignator 



A formal file designator that has the form 

filename[* groupname [§accountname] ] [fnoctespec] 

in which filename, groupname, and accountname are the identifiers that 
form a fully qualified filename. Each identifier may contain from one to 
eight alphnumeric characters, beginning with an alphabetic character. This 
filename may be used to identify the file in subsequent commands or in- 
trinsic calls. 

The nodespec extension of the formal file designator, explained below, is a 
parameter shared with the NS/3000 AdvanceNet subsystem and the 
DS/3000 subsystem. It is not part of the Fundamental Operating System. 
MPE accepts this extended formal file designator, with a node specification 
following a colon (:), in :FILE and : RESET and in the FOPEN intrinsic. 
Refer to the : RESET command in this section and also the MPE V Intrinsics 
Reference Manual (32033-90007). 

You should be aware that the FOPEN intrinsic recognizes only filename in 
the formalfidesignator. FOPEN ignores any groupname or accountname 
specifications. 
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$NULL 



$NEWPASS 

OLDPASS 

$STDIN 

$STDINX 

$STDLIST 
filereference 



nodespec 



If formaldesignator is not equated to another file designation, the parame- 
ter specifies the name of an actual file. Placing an asterisk ahead of the 
parameter {*formaldesignator) establishes a backreference to a formal file 
designator defined in a : FI LE command. 

The default is a temporary, nameless file that may be written to but not 
saved. 

Actual file designator of a system defined file that is always treated as an 
empty file. When $NULL is accessed by a program for input, that program 
receives only an end-of-file indication. When it is accessed by a program 
for output, the associated write request is accepted by MPE, but no physical 
output is actually performed. 



When $NEWPASS is closed, it is 
Opening $NEWPASS destroys any 



A system defined temporary job file, 
referenced by the name $OLDPASS. 
previous $NEWPASS temporary file. 

The system defined name of the last temporary file that was closed as 
$NEWPASS. 



The system defined name of the standard job input device, 
the first character read on this file indicates end-of-file. 



A colon ( : ) as 



The same as $STDIN except that a colon can be read as the first character 
and received as data (: : EOF : and : EOD statements cannot be read as data). 

The system defined name for the standard job or session limit device. 

The actual file designator of the file, which has the form 

filencune\Mlockword] [|grroMp«ame[|accountname] ] 

Each identifier may contain from one to eight alphanumeric characters, 
beginning with an alphabetic character. In a batch job, the file will fail to 
open if the file has a lockword that is not specified in filereference. In a 
session, MPE will prompt you for a lockword if one exists. 

An extension of the formal file reference. It may be an environment iden- 
tification (specified in a previous :DSLINE or : REMOTE command), or it 
may be $BACK. It may appear in the formal file designator of the file or as 
an extension of an actual file reference. If an environment identification 
appears in a file designation and in the DEV= option, an attempt to open the 
file (with the FOPEN intrinsic, for example) produces an error. 

$BACK instructs MPE to "hop backward" one node toward your local system 
to find the specified file. This works only if the : FILE command is issued 
in a remote session. If the systems involved are connected in a Local Area 
Network (LAN), one "hop backward" always means returning to your local 
system. The $BACK specification is the same as DEV=# without an environ- 
ment name. 



2-123 



NOTE 

The node spec parameter and the :DSLINE and : REMOTE 
commands are not part of the HP 3000 Fundamental 
Operating System. The NS/3000 AdvanceNect subsystem 
or the DS/3000 subsystem must be purchased separately. 
The nodespec parameter is optional: if you do not have 
NS/3000 AdvanceNet or DS/3000, omitting the nodespec 
parameter will make no difference in the performance of 
the : FILE command. 

However, specifying nodespec on a system that does not have 
NS/3000 or DS/3000 will produce an error. The nodespec 
parameter is controlled by the NS/3000 or DS/3000 subsys- 
tem. Refer to the NS/3000 User/Programmer Reference 
Manual (32344-90001) or the DSN/DS User/Programmer 
Reference Manual (321 89-90001). 

filedomain The domain of the file, which may be OLD, NEW, or 

OLDTEMP. 

NEW Creates a new file, which becomes the default. The NEW 

file may be permanent or temporary, depending on how 
the file was created. You must use either the : BUI LD 
command or the FOPEN intrinsic to create the file. 
Refer to the : BUILD command in this section. 

OLD Specifies an existing permanent file that was saved in 

the system or in the Private Volume domain. The file 
continues to exist after the current job or session ends. 

OLDTEMP Specifies a temporary file that already exists in the tem- 

porary session or job file domain. The file is deleted at 
the end of the current job or session. 

envname This may be a nodespec, a DS device class name, logical device number, or 

an X. 25 node name. Over the DS compatible links, the logical device num- 
ber must not be preceded by the DSLDEV prefix. Instead, use just the logical 
device number. The parameter envname may consist of as many as eight 
alphanumeric characters, beginning with an alphabetic character. 
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NOTE 



device 



The envname parameter is not part of the HP 3000 
Fundamental Operating System. The NS/3000 AdvanceNet 
subsystem or the DS/3000 subsystem must be purchased 
separately. The envname parameter is optional: If you do 
not have NS/3000 AdvanceNet or DS/3000, omitting the 
envname parameter will make no difference in the perfor- 
mance of the :FILE command. 

However, specifying envname on a system that does not have 
NS/3000 or DS/3000 will produce an error. The envname 
parameter is controlled and by the NS/3000 or DS/3000 
subsystem. Refer to the NS/3000 User/Programmer 
Reference Manual (32189-90001) or the DSN/DS 
User/Programmer Reference Manual (32344-90001). 

The logical device name or logical device number of a device, such as a disc, 
tape, printer, or a terminal. The default is DISC. If the DEV= option ap- 
pears, it must be followed by at least one parameter (the parameter can be 
simply #). 



outpri 



numooptes 



VTERM 



en of He 



If you are opening a file that is to reside on a Private Volume, you must 
specify a device class that includes the drives upon which the home volume 
set is mounted. The files is then allocated to any of the volume set's 
volumes that fall within that class. The default device class is DISC. A 
previously defined environment identifier is permitted in the DEV= option, 
but the domain and organization qualifiers are not permitted. 

The output priority requested for a spooled device. This may have a value 
of 1 (the lowest priority) to 1 3 (the highest). 

The number of copies requested for a spooled output devicefile. The maxi- 
mum number is 1 27. 

Instructs MPE to use the Reverse Virtual Terminal service instead of the 
Remote File Access. You may use VTERM only if the designated device is a 
remote terminal. Using VTERM allows a local application program to per- 
form I/O to remote terminals located on systems which support Reverse 
Virtual Terminal. Refer to "Communicator 3000", Volume 2, Issue 7 
(5958-3139) for Version G.02.00 of MPE V/E "U-MIT". 

The name of a file containing laser printer environment information, which 
controls the printing output formats on the laser printer. This name may 
be an actual file designator, or it may be a formal file designator preceded 
by an asterisk (*). 



The information in this file contains such specifications as page size, the 
character font, forms, and other printer requirements to be used with the 
HP Laser Printing System, entered with IDS/3000 and IFS/3000. The file 
must be in a form suitable for downloading to the HP 268 0A, 2688, 2 56 3 A, 
or 2608S. 



2-125 



AUG 1986 



To specify an environment file called TRADMIN.HPENV.HP2680A for a 
form printed on the HP2680A, enter: 

:FILE LP;DEV=LASER;ENV=TRADMIN.HPENV.HP2680A 

Refer to the IFS/3000 Reference Guide (36580-90001) for discussions on 
creating environment files. 

The ENV= parameter in a :FILE command overrides the environment 
specified in the FOPEN intrinsic. If the ENV= parameter is used and the 
*formalfiledesignator sor filereference is omitted, any environment file 
specification in a subsequent FOPEN of the devicefile is ignored. 



option Any valid option for the : FILE command. 



SYNTAX FOR OPTION 



IREC- [reosize] Mblockfactor] [I{U>[l^JJJ Y j]]]] 

%DEti= [density]] 

|DISC=[rtwmrec] [^numextents] [iinitialloc] ] 

§CODE=[filecode] ] 

,{|RIO ), 
l {i|NORIO} J 

<iSTD> 

{;MSG}] 

{?CIR> 



PARAMETERS FOR OPTION 

recsize Record size. A positive number indicates words, while a negative number 

indicates bytes for new files only. For fixed length files, this is the logical 
record size. For undefined length files, this is the maximum record size. 
For variable length files, this is the maximum logical record size if block fac- 
tor is 1. If not, this is used to calculate the maximum logical record size 
and physical record size. 

Records always begin on word boundaries. Therefore, the record size is 
rounded up to the nearest word boundary for block size calculations. For a 
binary file or a variable length ASCII file, odd byte lengths are rounded up 
and the extra byte is available for data. 
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However, if an odd byte length record size is specified for a fixed or un- 
defined length record file, the extra byte is not available for data. Default 
is the configured physical record width of the associated device. If you do 
not use the DEV= parameter, the default will be DISC with 128 records. 



blockfactor 



For example, a fixed length ASCII file with a record size specified as 1 1 
bytes will have only 1 1 bytes available for data in each logical record. 
However, to determine actual block size, 12 bytes will be used for the 
record size (block size = 1 2 bytes multiplied by the blockfactor). If the file 
was specified as a binary file, the 1 1 bytes would be rounded up to 12 bytes 
(6 words), all of which are available for each logical record. 

Number of logical records per physical block, for new files only. Default is 
calculated by dividing the specified recsize into the configured block size; 
this value is rounded downward to an integer that is never less than 1. For 
variable length record files, blockfactor is always set to 1 after using the 
original value along with recsize to calculate maximum logical record size 
and physical record size. The blockfactor is ignored for undefined length 
records. Maximum size is 255. 



F, U, or V 



Defines the format of the records of the file. A file may contain fixed 
length records (F), undefined length records (U), or variable length records 
(V). Default is F for disc files. 



BINARY or ASCII 



Indicates the type of records. BINARY indicates binary coded records and 
is the default. ASCII indicates ASCII coded records. 



density 



Corresponds to tape densities in BPI (bits-per-inch) for new files only. This 
parameter is only applicable when writing to a tape mounted on the HP 
7976A or HP 7978A, variable density tape drive. 



The density value from a file equation takes precedence over the density 
specified in FOPEN. The supported densities are 800 , 1600 and 6250. For 
details on the operation of density selection, refer to FOPEN in the MPE V 
Intrinsics Reference Manual (32022-90007). 



numrec 



Maximum number of logical records, for new files only. For fixed and un- 
defined length files the maximum value allowed for this field is 
2,147,483,647. However, the maximum sectors per file is 2,097,120 
based on the maximum of 65535 sectors per extent, 32 extents maximum. 
Thus the actual maximum number of records will be limited by block size 
(determined by recsize and blockfactor). An approximate practical limit for 
numrec is 2,097,119 for files with variable undefined lengths, and 
267,382 ,000 for fixed length files. Default is 1 023. 
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NOTE 

The file system uses these values to compute other charac- 
teristics of the file as well. Therefore, the values (or default 
values) specified in the : FI LE command may be valid within 
their respective fields, but may cause overflow errors in the 
computation of internally needed file specifications. 

Refer to the MPE File System Reference Manual 
(30000-90236) for a discussion on calculating file space. 



numextents 



Maximum number of disc extents. 
8. 



This is a value from 1 to 32. Default is 



initialloc 
filecode 



Number of extents to be initially allocated to the file at the time it is 
opened. This is a value from 1 to 32. Default is 1. 

Code indicating a specially formatted file. This code is recorded in the file 
label and is available to processes accessing the file through the FGETINFO 
intrinsic. For this parameter, any user can specify a positive integer rang- 
ing from to 32767 or a mnemonic name. Certain integers and 
mnemonics have been reserved for particular HP defined meanings, as 
follows: 



Integer Mnemonic Meaning 



1024 


USL 


User Subprogram Library 


1025 


BASD 


BASIC Data 


1026 


BASP 


BASIC Program 


1027 


BASFP 


BASIC Fast Program 


1028 


RL 


Relocatable Library 


1029 


PROG 


Program file 


1030 


NMPRG 


Native Mode Program file 


1031 


SL 


Segmented Library 


1032 


NMSL 


Native Mode Executable Library file 


1033 


NMRL 


Native Mode Relocatable Library file 


1035 


VFORM 


View Form file 


1036 


VFAST 


View Fast Forms file 


1037 


VREF 


View Reformat file 


1040 


XLSAV 


Cross Loader ASCII file (SAVE) 


1041 


XLBIN 


Cross Loader Relocated Binary file 


1042 


XLDSP 


Cross Loader ASCII file (DISPLAY) 


1050 


EDITQ 


Edit Quick file 


1051 


EDTCQ 


Edit KEEPQ file (COBOL) 


1052 


EDTCT 


Edit TEXT file (COBOL) 


1054 


TDPDT 


TDP Diary file 


1055 


TDPQM 


TDP Proof Marked QMARKED 


1056 


TDPP 


TDP Proof marked non -COBOL file 


1057 


TDPCP 


TDP Proof Marked COBOL file 


1058 


TDPQ 


TDP Workf ile 


1059 


TDPXQ 


TDP Workf ile (COBOL) 
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Integer Mnemonic Meaning 



1060 


RJEPN 


RJE Punch file 


1070 


QPROC 


QUERY Procedure file 


1080 


KSAMK 


KSAM Key file 


1083 


GRAPH 


GRAPH Specification file 


1084 


SD 


self -describing file 


1090 


LOG 


User Logging logf ile 


1100 


WDOC 


HPWORD Document 


1101 


WDICT 


HPWORD Hyphenation dictionary 


1102 


WCONF 


HPWORD Configuration file 


1103 


W2601 


HPWORD Attended Printer Environment 


1110 


PCELL 


IFS/3000 Character Cell file 


1111 


PFORM 


IFS/3000 Form file 


1112 


PENV 


IFS/3000 Environment file 


1113 


PCCMP 


IFS/3000 Compiled Character Cell file 


1114 


RASTR 


Graphics Image in RASTR Format 


1130 


OPTLF 


OPT/ 3 000 logf ile 


1131 


TEPES 


TEPE/3000 Script file 


1132 


TEPEL 


TEPE/3000 logfile 


1133 


SAMPL 


APS/3000 logfile 


1139 


MPEDL 


MPEDCP/DRP logfile 


1140 


TSR 


HPToolset Root file 


1141 


TSD 


HPToolset Data file 


1145 


DRAW 


Drawing File for HPDRAW 


1146 


FIG 


Figure File for HPDRAW 


1147 


FONT 


Reserved 


1148 


COLOR 


Reserved 


1149 


D48 


Reserved 


1152 


SLATE 


Compressed SLATE file 


1153 


SLATW 


Expanded SLATE workf ile 


1156 


DSTOR 


Store file for RAPID/3000 Utility DICTDBU 


1157 


TCODE 


Code file for Transact/ 3 000 Compiler 


1158 


RCODE 


Code file for Report/3000 Compiler 


1159 


I CODE 


Code file for Inform/ 3 000 Compiler 


1166 


MDIST 


HPDESK Distribution list 


1167 


MTEXT 


HPDESK Text 


1168 


MARPA 


ARPA Message file 


1169 


MARPD 


ARPA Distribution list 


1170 


MCMND 


HPDESK Abbreviated Commands file 


1171 


MFRTM 


Reserved 


1172 




Reserved 


1173 


MEFT 


Reserved 


1174 


MCRPT 


Reserved 


1175 


MSERL 


Reserved 


1176 


UCSF 


Reserved 


1177 


TTYPE 


Term Type file 


1178 


TVFC 


Term Vertical Format Control file 


1192 


NCONF 


Network Configuration file 


1193 


NTRAC 


Network Trace file 


1194 


NLOG 


Network logfile 


1195 


MIDAS 


Reserved 


1211 


ANODE 


Reserved 


1212 


I NODE 


Reserved 
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Integer Mnemonic Meaning 





1213 


INVRT 


Reserved 




1214 


EXCEP 


Reserved 




1215 


TAXON 


Reserved 




1216 


QUERF 


Reserved 




1217 


DOCDR 


Reserved 




1226 


VC 


VC file 




1227 


DIF 


DIF file 




1228 


LANGD 


Language Definition file 




1229 


CHARD 


Character Set Definition File 




1230 


MGCAT 


Formatted Application Message Catalog 




1236 


BMAP 


Reserved 




1242 


BDATA 


Basic Data file 




1243 


BFORM 


Basic Field Order File for VPLUS 




1244 


BSAVE 


Basic Saved Program file 




1245 


BCMFG 


Configuration File for Default Option Basic Program 




1246 


BKEY 


Function Key Definition file 




1258 


PFSTA 


Pathflow STATIC file 




1259 


PFDYN 


Pathflow DYNAMIC file 




1270 


RTDCA 


Revisable Form DCA Document 

(DCA ■ Document Content Architecture) 




1271 


FFDCA 


Document Interchange Unit file 
HPWORD/1 50 Document 




1272 


DIU 


DISOSS Filing Information file 




1273 


PDOC 


Search Result Information file 




1275 


DFI 


Reserved 




1276 


SRI 


HPMAP/3000 Map Specification file 




1401 


CWPTX 


Reserved 




1421 


MAP 


Reserved 




1422 


GAL 


HPBRW Dictionary file 




1425 


TTX 


HPBRW Specification file 




1428 


RDIC 


HPBRW Specification file (frozen) 




1429 


RSPEC 


HPBRW Execution file 




1430 


RSPCF 


HPBRW Report Job file 




1431 


REXEC 


HPBRW Intermediate Report file 




1432 


RJOB 


HPBRW Dictionary Output file 




1433 


ROUTI 


HPBRW Print file 




1434 


ROUTD 


HPBRW Configuration file 




1435 


PRINT 


Reserved 




1436 


RCONF 


Native Mode Object file 




1441 


PIF 


PASCAL Source Library 




1461 


NMOBJ 


Reserved 




1462 


PAS LB 






3333 








Default 


is the unreserved file code of 0. 


RIO or NORIO 


Creates 


a relative or 


nonrelative I/O file. RIO creates a relative I/O file. 



The record length parameter will be implicitly changed to fixed record 
length. RIO is a special file access method primarily intended for use by 
COBOLII programs; however, you can access these files by programs written 
in any language. NORIO creates a nonrelative I/O file. Default is NORIO. 
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RIO and NOR 10 specifications affect only the physical characteristics of the 
file. If NOBUF is specified in the :FILE command, the file will be accessed 
in non-RIO mode; otherwise RIO access is used with RIO files. NOBUF ac- 
cess is provided for special operations on RIO files such as replicating RIO 
file. NOBUF is not normally used by the RIO user. Refer to the MPE V 
Intrinsics Reference Manual (32033-90007) for a discussion of relative 
I/O. 



STD, MSG, or CIR 



Defines the type of file. STD is a standard MPE disc file. MSG (message) 
file allows communication between any set of processes. MSG acts like a 
FIFO (first in, first out) queue where records are read from the start of the 
file and logically deleted and/or are appended to the end of file. CIR acts 
as normal sequential file until full. When full, the first physical block will 
be deleted when the next record is written, and remaining blocks will be 
logically shifted to front of file. CIR cannot be simultaneously accessed by 
readers and writers. Default is STD. 



SYNTAX FOR ACCESS 



^pOCCTL}, 
l {lCCTL > J 



{IN } 
(OUT } 
[lACC= [{UPDATE }]] 
{0UTKEEP} 
{APPEND ) 
{INOUT ) 



[ 



{ ? BUF= [ numbuffers] } 



{INOBUF 



} 



«EXC > 
r {lSHR >, 
1 <!§EAR > J 

USEMI} 



{fNOLABEL 



{IBM} 



{ifNOMULTI 
[{plULTI 
{pMULTI 

r {llNOMR 
Mis MR 



{ 5 WAIT 
{fNOWAIT 



r {lLOCK 
l UNOLOCK 



{§C0PY 
{^NOCOPY 



[lF0RMS=formsmsg] 



<!LABEL= [oolsetid ) [£ [ J *™ } ' ] [[ [expdate] \Mseq] ] ] } 



PARAMETERS FOR ACCESS 



NOCCTL or CCTL 



Indicates whether carriage control characters are or are not specified. 
NOCCTL indicates that carriage control characters are not being specified in 
writes to the file. CCTL indicates that carriage control characters are being 
supplied in writes to the file. Default is NOCCTL. 
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IN, OUT, UPDATE, 
OUTKEEP, APPEND, or 
INOUT 



BUF =numbuffers or 
NOBUF 



EXC, SHR, EAR, or SEMI 



NOLABELor LABEL 



Defines the type of file access. IN only permits READ access to the file 
and is the default for all input devices. OUT only permits WRITE access to 
the file and is the default for output devices. UPDATE permits any type of 
access to the file. OUTKEEP only permits WRITE access to the file, except 
previous data is not deleted. APPEND only permits APPEND access to any 
file. INOUT only permits input/output access; any file intrinsic except 
FUPDATE can be issued against the file. 

Specifies whether buffers are to be allocated to the file. The numbuffers 
parameter is the number of buffers (1 to 16) to be allocated for the file. 
The numbuffers parameter is ignored for terminals. The default is BUF =2 
buffers. NOBUF specifies that no buffers are allocated for the file. 

Specifies shared or exclusive file access. EXC is exclusive access; after the 
file is opened no other accessors are permitted. For message and circular 
files, EXC means one writer and one reader. SHR is share access; after the 
file is opened other accessors are permitted. EAR and SEMI are identical. 
For message files they allow one exclusive reader and multiple writers. For 
non-message files they allow one exclusive writer and multiple readers. 
Default is EXC except with read only file access (IN). 

Specifies if this tape is labeled or unlabeled. NOLABEL specifies that this is 
not a labeled tape. LABEL specifies that this is a labeled tape. Default is 
NOLABEL. 



vol set id 



Up to six alphanumeric characters identifying a labeled magnetic tape 
volume set. 



ANSor IBM 



Type of standard label. ANS is ANSI -standard label, 
label. Default is ANS. 



IBM is IBM -standard 



expdate 



seq 



Month, day, year, written in the format mm/dd/yy. This specifies the 
expiration date of the file, or the date after which information contained in 
the file is no longer useful. The file can be overwritten without operator 
reconfirmation after this date. Default is 00/00/00: the file can be 
overwritten immediately. 

Either an absolute file number between 1 and 9999 (inclusive), or one of 
the following, which specifies the position of the file relative to other files 
on the tape: 




ADDF 



Causes a search of all volumes until the file is found. 

ADDF positions the tape to add a new file on the end of 
the volume (or last volume in a multivolume set). Note 
that ADDF should not be used to add to a new labeled 
tape volume. 
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NEXT 



NEXT positions the tape at the next file on the tape. If 
this is the first FOPEN, then NEXT will cause the tape to 
be positioned to the first file on the tape. If the 
previous FCLOSE specified REWIND, the tape backspaces 
to the last file, and the position is as it was, on the 
previous file. This is the Default. Refer to FOPEN in 
Section II of the MPE V Intrinsics Reference Manual 
(32033-90007) for more information. 



NOMULTI, MULTI, or 
GMULTI 



Specifies the sharing of files in jobs and sessions. NOMULTI prohibits shar- 
ing files in MULTI mode and is the default. MULTI allows concurrent acces- 
sor of the file and may regard the file as if no buffering is taking place. 
Access control information can be shared by the processes of the same CI 
process tree (i.e. father-to-son processes) with MULTI. GMULTI is the same 
as MULTI except it allows accessors to be in different jobs/sessions. 



NOMR or MR 



Specifies whether multirecord access is permitted. NOMR specifies that no 
multirecord access is permitted. MR allows multirecord access to the file. 
Default is NOMR. 



WAIT or NOWAIT 



NOLOCK or LOCK 



COPY or NOCOPY 



formsmsg 



Specifies whether I/O requests are to be completed or queued before control 
returns to the program. WAIT completes I/O requests to the file before 
control is returned to the program. NOWAIT returns control to the program 
as soon as I/O requests are queued by MPE; only Privileged Mode programs 
are allowed. In this way, the program does not have to wait for the physi- 
cal I/O to be complete before resuming execution and also implies NOBUFF. 

Specifies whether dynamic locking/unlocking is to be permitted. NOLOCK 
prohibits dynamic locking/unlocking of file through the FLOCK/FUNLOCK 
intrinsics. LOCK allows dynamic locking/unlocking through 

FLOCK/FUNLOCK intrinsics. Default is NOLOCK. 

Specifies whether files can be copied. COPY allows MSG, KSAM, and CIR 
files to be either copied (logical data record read) or replicated (block read 
and write completely duplicating file) to another file. NOCOPY accesses the 
file in its natural mode, i.e. as a MSG file. Default is NOCOPY. 

A message to the operator requesting that certain forms be mounted. The 
message must be displayed and verified before the output data can be print- 
ed on a line printer. The message is a string of no more than 49 ASCII 
characters terminated by a period. Control characters for bells and inverse 
video may be sent to the System Console using this parameter. Attempts to 
send other control characters, however, will result in a display of blanks 
and the associated control character letter when the forms message appears 
on the System Console. Default is no forms message sent. 
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SYNTAX FOR DISPOSITION 



(IDEL } 

KITEMP}] 

{iSAVE} 



PARAMETERS FOR DISPOSITION 

DEL The file is deleted when closed. 

SAVE The file is saved in the permanent file domain when closed. 

TEMP The file is saved in the job/session temporary domain when closed. 

If none of these parameters are supplied, the disposition of the file is as it was when opened, or as specified 
by the FCLOSE intrinsic call issued by the user program. Refer to the MPE File System Reference Manual 
(30000-90236) for more information on file domains. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

This command allows you to change the specifications for files at run time, including the devices on which 
they reside, overriding specifications supplied via the FOPEN intrinsic. The :FILE command remains in 
effect for the entire job or session unless revoked by the : RESET command or superseded by another 
: FILE command. 

To use the :FILE command for a file, you must have a valid, formal file designator (the name by which 
your program recognizes the file). The formal file designator provides a way for commands and code 
outside your program to reference the file. 



NOTE 



When you are programming in a language other than SPL, 
and you did not write the FOPEN intrinsic calls for files used 
by your program, the :FILE command is the only way you 
can control or change the programmatic file specifications. 
(Refer to the reference manual of the language you are 
using for more detail.) 
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EXAMPLES 

A program, MYPROG, references two files by the filenames (formaldesignators) SOURCE and DEST, but you 
wish to use two existing disc files I NX and OUTX as the actual files for the program. Enter: 

; FILE SOURCE=INX 
: FILE DESTOUTX 
: RUN MYPROG 

Now you wish to run the program using input from a card reader which has 80-byte records and has the 
device class name CARD : 

: FI LE SOURCE , OLD ; REC=-80 ; DEV=CARD 

Output is to be sent to a new file, FILEX, with 64-word fixed length records, blocked two records per 
block in ASCII code. FILEX is limited to 800 records among 10 extents, two of which are to be im- 
mediately allocated. The file is to be permanently saved when MY PROG closes it. Enter: 

: FILE DEST=FILEX,NEW;REC=64,2,F,ASCII;DISC=800,10,2;SAVE 
; RUN MYPROG 

Note that the file equation only modifies those items specified. All other attributes used will come from 
the parameters specified in the FOPEN call (or the defaults where parameters are omitted) for the file 
DEST. 

Implicit :FILE Commands for Subsystems 

When an actual file designator appears as a command parameter, it is automatically equated to a formal 
file designator. This is then used within the subsystem by an implicit :FILE command issued by the 
command executor. For instance, within the FORTRAN compiler the formal file designator for the text 
file input is FTNTEXT . Suppose you specify a file named ALSFILE for text file input as shown below: 

: FORTRAN ALSFILE 

MPE implicitly issues the following : FILE command, invisible to you: 

:FILE FTNTEXT=ALSFILE 
You cannot backreference any of the formal file designators associated with the command as actual file 
designators. Therefore, do not, use the formal file designators FTNTEXT, FTNUSL, FTNLIST, FTNMAST or 
FTNNEW as actual filenames. The use of FTNTEXT as a filename, as in the following example, is invalid be- 
cause the implicit :FILE command issued by the FORTRAN compiler will then backreference itself: 

: FORTRAN ;«FTNTEXT 
: FILE FTNTEXT=»FTNTEXT 

The following is an example of a correct use of the *formaldesignator, in this case specifying a file on 
magnetic tape used as a source file during a FORTRAN compilation: 

: FILE SOURCE=TAPE1 > OLD;DEV=TAPE;REC=-80 
: FORTRAN; "SOURCE 
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Implicitly, the command executor issues the following :FILE command, backreferencing your previous 
:FILE command: 

:FILE FTNTEXT=*SOURCE 

Implicit :FILE commands, like explicit :FILE commands, cancel any previous :FILE commands that 
reference the same formal file designators. Formal file designators are described in each compiler com- 
mand description throughout this manual. 

ADDITIONAL DISCUSSION 

MPE V Intrinsics Reference Manual (32033-90007) 
MPE File System Reference Manual (30000-90236) 
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:FOREIGN 



Directs MPE to treat the disc volume mounted on the specified Idev as foreign. 

SYNTAX 



: FOREIGN IdeO 



PARAMETERS 

IdeO The logical device number of a disc drive. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

This command forces MPE to treat the volume currently mounted on the logical device as a foreign disc. 
The device class associated with the logical device must be foreign and the drive must be online, but the 
volume cannot be in use. 



| CAUTION 



If the restrictions stated above are met, the system will treat 
the logical device as a foreign disc. As long as the volume is 
not a System Domain disc, MPE performs no security check- 
ing. Therefore, any disc (system, private volume, etc) could 
be mounted and inadvertently treated as a foreign disc. 
Since the Foreign Disc Facility may write on the MPE label 
area, file labels could be destroyed and important informa- 
tion lost. 
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EXAMPLES 

To direct MPE to treat the disc mounted on device 3 as foreign, first verify the status of the disc by 
entering: 



:DSTAT 3 



LDEV-TYPE 



STATUS VOLUME (VOLUME SET-GEN) 



3-7902 
Then enter: 

: FOREIGN 3 
To verify the change, enter: 

:DSTAT 3 



SERIAL 



*UNAL LOCATED* 



LDEV-TYPE 



STATUS VOLUME (VOLUME SET-GEN) 



3-7902 



FOREIGN 



♦UNALLOCATED* 
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:FORTGO 



Compiles, prepares, and executes a FORTRAN/3000 program. FORTRAN/3000 is not part of the HP 
3000 Fundamental Operating Software and must be purchased separately. 



SYNTAX 




PARAMETERS 

text file 

listfile 
masterfile 

new file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. The formal file designator is 
FTNTEXT. Default is $STDIN. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. The formal file designator is FTNLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfUe is merged to 
produce a composite source. This can be any ASCII input file. The formal 
file designator is FTNMAST. Default is that the file is not read; input is read 
from text file, or from $STDIN if text file is not specified. 

Actual file designator of the file resulting from merging of textfile and 
masterfile. This can be any ASCII output file. The formal file designator is 
FTNNEW. Default is that the file is not written. 



USE 



NOTE 



The formal file designators used in this command (FTNTEXT, 
FTNLIST, FTNMAST, and FTNNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information, refer to the "Implicit :FILE 
Commands For Subsystems" discussion of the MPE :FILE 
command. 



This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 
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OPERATION 

The :FORTGO command compiles, prepares, and executes a FORTRAN/ 3 000 program. If you do not 
specify a source file, MPE expects input from your standard input device. If you do not specify listfUe 
MPE writes the listing to your standard output device. 

The USL file created during the compilation is a system defined temporary file $OLDPASS, which is passed 
directly to the Segmenter, and cannot be accessed. 

EXAMPLES 

To compile, prepare, and execute a FORTRAN/3000 program entered from the disc file SOURCE and 
transmit the resulting program listing to the disc file LISTFL, enter 

t FORTGO SOURCE, L I STFL 

To enter your source input from a device other than your standard input device, and/or direct the listing 
to a device other than your standard list device, simply name the input and listing files as command 
parameters. In the example below, the source listing is read from magnetic tape, formally identified by 
the filename MTAPE. Output is sent to the printer, identified by the filename PRTR. 

t FILE MTAPE;DEV=TAPE 
: FILE PRTR;DEV=FASTLP 

MTAPE and PRTR are then backreferenced in the : FORTGO command, as shown here: 
t FORTGO "MTAPE .» PRTR 

ADDITIONAL DISCUSSION 

FORTRAN/ 3000 Reference Manual (30000-90040) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:FORTPREP 



Compiles and prepares a FORTRAN/3000 program. FORTRAN/3000 is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 



SYNTAX 



:F0RTPREP [text file) Mprogfile] [ 1 [list file] [|| [masterfile] [gnetifile] ] ] ] 



PARAMETERS 

text file 

prog file 



listfile 
masterfile 

new file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. The formal file designator is 
FTNTEXT. Default is $STDIN. 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the MPE Segmenter will create the 
program file, which will reside in the temporary file domain as $OLDPASS. 
If you create your own program file, you must do so in one of two ways: 

• Use the MPE : BUILD command, and specify a file code of 1029 or 
PROG, and a numextents value of 1. This file is then used by the : PREP 
command. 

• Specify a nonexistent file in the progfile parameter, resulting in the 
creation of job/session temporary file of the correct type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. The formal file designator is FTNLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. The formal 
file designator is FTNMAST. Default is that the master file is not read; input 
is read from text file, or from $STDIN if textfile is not specified. 

Actual file designator of the file resulting from the merger of textfile and 
masterfile. This can be any ASCII output file. The formal file designator is 
FTNNEW. Default is that the file is not written. 
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NOTE 

The formal file designators used in this command (FTNTEXT, 
FTNLIST, FTNMAST, and FTNNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information, refer to the "Implicit :FILE 
Commands For Subsystems" discussion of the MPE :FILE 
command. 



USE 



This command may be issued from a Session or a Job. It may not be used from a Program or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

This command compiles and prepares a FORTRAN/ 3 000 program into a program file stored on disc. If 
you do not specify a source file, MPE expects the input from your standard input device. If you do not 
specify a listfile, MPE sends the output to your standard list device. 

The USL file created during compilation is a system defined temporary file $0LDPASS, which is passed 
directly to the Segmenter. The Segmenter also uses the file OLDPASS. The prepared program segments 
are written to it, thus overwriting any existing temporary file of that name. 

If you have no need to examine the USL file, use the default for progfile. This way, MPE will create a 
program file for you, ensuring the best results. If, on the other hand, you want to store the USL file and 
the program file as separate entities, create a permanent program file with the : BUILD command, and 
reference it in the rFORTPREP command line. When you create the file, you must specify a file code of 
"PROC?" or "1029" and a numextents parameter value of 1, as shown in the example below. 

; BUILD PRO0X;C0DE=PROG;DISC=t 

EXAMPLES 

To compile and prepare a FORTRAN/3000 program entered from your standard input device, into the 
standard default file $0LDPASS, with the listing printed on your standard list device, enter: 

r FORTPREP 

To compile and prepare a FORTRAN/ 3 000 source program from a textfile named TEXTX into a program 
filenamed PROGX, with the resulting listing sent to the list file LISTX, enter: 

r FORTPREP TEXTX .PROOX.LISTX 
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The rFORTPREP command combines the compilation and preparation steps. The compiled program 
segments, stored in the file $OLDPASS, are prepared and stored in the program file PROGX. Therefore, it is 
equivalent to: 

; FORTRAN TEXTX, LISTX 
: PREP $OLPPASS, PROGX 

ADDITIONAL DISCUSSION 

FORTRAN/3000 Reference Manual (30000-90040) 
MPE Segmenter Reference Manual (30000-9001 1) 



2-142 



FORTRAN 



Compiles a FORTRAN/3000 program. FORTRAN/3000 is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 



SYNTAX 



:F0RTRAN [textfile] \§[uslfile\ Mlistfile] [.[masterfile] [Mnewfile] ] }] 



PARAMETERS 

textfile 
uslfile 



List file 



masterfile 



newfile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. The formal file designator is 
FTNTEXT. Default is $STDIN. 

Actual file designator of the User Subprogram Library (USL) file to which 
the object program is written, which can be any binary output file with file 
code of USL or 1024. The formal file designator is FTNUSL. If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$OLDPASS. If entered, the file must have been created in one of four ways: 

• By using the MPE :SAVE command to save default USL file SOLDPASS 
created during a previous compilation. 



By building the USL with the Segmenter -BUILDUSL command, 
to the MPE Segmenter Reference Manual (30000-9001 1).) 



(Refer 



• By creating a new USL file with the MPE : BUILD command and 
specifying with a file code of USL or 1 024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is FTNLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is FTNMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the merged textfile and masterfile. This can be 
any ASCII output file. Formal file designator is FTNNEW. Default is that 
no file is written. 
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NOTE 

The formal file designators used in this command (FTNTEXT, 
FTNUSL, FTNLIST, FTNMAST, and FTNNEW) cannot be 
backreferenced as actual file designators in the command 
parameter list. For further information, refer to the 
"Implicit :FILE Commands For Subsystems" discussion of the 
MPE :FILE command. 

USE 

This command may be issued from a Session or Job. It may not be used from a Program or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

This command compiles a FORTRAN/ 3 000 program into a USL file on disc. If you do not specify 
text file, MPE expects input from your standard input device. If you do not specify listfUe, MPE sends the 
listing to your standard list device. 

If you create the USL file (using the MPE : BUI LD command) before compiling the program, you must as- 
sign it a file code of USL or 1024. If you omit this parameter, the compiled program segments will be 
stored in the temporary file $OLDPASS. 

EXAMPLES 

To compile a FORTRAN/3000 program entered from your standard input device into an object program 
in the USL file $OLDPASS, and write the listing to your standard list device, enter: 

; FORTRAN 

The following example compiles a program from the source file MYSOURCE and stores the object code into 
the USL file MYUSL. The program listing will be stored in the disc file NYLIST: 

; F0RTRAN MYSOURCE, MYUSL, MYLIST;INFQ= "$CONTROL BOUNDS" 

To compile a FORTRAN/3000 program and store the object code into a USL file you create with the 
: BUI LD command, enter: 

: BUILD OBJECT ;C0DE=USL **You must specify the CODE parameter as choose to 

: FORTRAN SOURCE , OBJECT, L I STFL create a USLf ile with the : BUI LD command. ** 



ADDITIONAL DISCUSSION 

FORTRAN/3000 Reference Manual (30000-90040) 
MPE Segmenter Reference Manual (30000-9001 1) 
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rFREERIN 

Releases a global Resource Identification Number (RIN). 

SYNTAX 



:FREERIN rin 



PARAMETERS 

number from 1 to the configured maximum. 



rtn The Resource Identification Number (RIN) to be released. It must be a 



USE 

This command may be issued from a Session or Job. It may not be used from a Program or in BREAK It 
is not Breakable. 

OPERATION 

A Resource Identification Number is used to manage a resource shared among two or more jobs or sessions 
so that only one job or session at a time can access that resource. 

Th *t U ^ r t^ ir ! S a RIN fr ° m the System by enterin * the •' GETRIN command. When all users are finished 
with the RIN, the user who acquired it returns it to the system by entering the : FREERIN command To 
tree a RIN you must be the original owner of that RIN, i.e. the user who actually issued the :GETRIN 
command that allocated the RIN and assigned it a password. 

EXAMPLE 

To release RIN 6, enter: 
.• FREERIN 6 

ADDITIONAL DISCUSSION 

MPE V Intrinsics Reference Manual (32033-90007) 
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:FTN 



Compiles a FORTRAN/77 program. FORTRAN/77 is not part of the HP 3000 Fundamental Operating 
Software and must be purchased separately. 



SYNTAX 



:FTN [text file] [, [uslfile] [^listfile]] 
[§lHFO=quotedstring] 



PARAMETERS 

text file 

uslfile 



listfile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is FTNTEXT. 
Default is $STDIN. 

Actual file designator of the USL file to which the object code is stored, 
which can be any binary output file with a file code of USL or 1 024. Its 
formal file designator is FTNUSL If the uslfile parameter is omitted, the 
object code is saved to the temporary file $0LDPASS. If entered, this pa- 
rameter indicates that the USL file was created in one of four ways: 

• By using the MPE :SAVE command to save, the default USL file 
$0LDPASS, created during a previous compilation. 

• By building the USL with the MPE Segmenter -BUILDUSL command. 
Refer to the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file specifying the MPE : BUILD command and 
specifying a file code of USL or 1 024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is FTNLIST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command ( FTNTEXT, 
FTNUSL, and FTNLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the MPE :FILE command. 
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quotedstring A sequence of characters between two single quotation marks (apostrophes) 

or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is con- 
sidered part of the string, and, therefore, not the terminating delimiter. 

IHFOyuotedstring is used in the FORTRAN/77 programming language to 
pass initial compiler options to a program. For more information, refer to 
the : RUN command in this section. 

USE 

This command may be issued from a Session or a Job. It may not be used from a Program or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

The :FTN command compiles a FORTRAN/77 program and stores the object code in a User Subprogram 
Library (USD file on disc. If text file is not specified, MPE expects the source program to be entered from 
your standard input device. If you do not specify a listfUe, MPE sends the program listing to your stan- 
dard list device and identifies it by the formal file designator, FTNLIST. 

If you create the USL prior to compilation, you must specify a file code of USL or 1024. If you omit the 
uslfile parameter, the object code is saved in the temporary file domain as $0LDPASS. To keep it as a 
permanent file, you must save $OLDPASS under another name. 

EXAMPLES 

The following example compiles a FORTRAN/77 program entered from your standard input device and 
stores the object program in the USL file $OLDPASS. The listing is then sent to your standard list device. 

:FTN 

The next example compiles a FORTRAN 77 program contained in the disc file FORTSRC, and stores the 
object program in the USL file FORTOBJ. The program listing is stored in the disc file LISTFILE. 

: BUILD FORTOBJ;CODE=USL 

; FTN FORTSRC , FORTOBJ , L I STF I LE 

ADDITIONAL DISCUSSION 

FORTRAN/ 7 7 Reference Manual (5957-4685) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:FTNGO 



Compiles, prepares, and executes a FORTRAN/77 program. FORTRAN/77 is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 



SYNTAX 



:FTNG0 [text file][^list file] 
[ I I N F0=quo t eds tring] 



PARAMETERS 

text file 
list file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is FTNTEXT. 
Default is $STDLIST. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is FTNLIST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command 
( FTNTEXT, and FTNLIST) cannot be backreferenced as ac- 
tual file designators in the command parameter list. For 
further information, refer to the "Implicit PILE Commands 
For Subsystems" discussion of the MPE :FILE command. 



quotedstring 



A sequence of characters between two single quotation marks (apostrophes) 
or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is con- 
sidered part of the string, and, therefore, not the terminating delimiter. 

INFO=quotedstring is used in the FORTRAN/77 programming language to 
pass initial compiler options to a program. For more information, refer to 
the : RUN command in this section. 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK. It 
is Breakable (suspends execution). 
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OPERATION 

The :FTNGO command compiles, prepares, and executes a FORTRAN/77 program. If text file is omitted, 
MPE expects input from your standard input device. If you do not specify listfile, MPE sends the program 
listing to the formal file designator FTNLIST (default is $STDLIST). 

I 

The USL file created during the compilation is the system defined temporary file $OLDPASS, which is 
passed directly to the Segmenter. It cannot be accessed because the Segmenter also uses $OLDPASS to store 
the prepared program segments, overwriting any existing temporary file of the same name. 

EXAMPLE 

To compile, prepare, and execute a FORTRAN/ 7 7 program entered from your standard input device, with 
the program listing sent to your standard list device, enter: 

; FTNGO 

To compile, prepare, and execute a FORTRAN/77 program from the disc file FORTSRC and send the 
program listing to the file LISTFILE, enter: 

: FTNGO FORTSRC, LISTFILE 

ADDITIONAL DISCUSSION 

FORTRAN/77 Reference Manual (5957-4685) 
MPE Segmenter Reference Manual (30000-9001 1) 
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FTNPREP 



Compiles and prepares a FORTRAN/77 program. FORTRAN/77 is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 

SYNTAX 



: FTNPREP [text file] 1 * [progfile] [Mist file] 
\MlliFO=quotedstring] 



PARAMETERS 

text file 
prog file 



list file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is FTNTEXT. 
Default is $STDIN. 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the MPE Segmenter creates the 
program file, which will be stored in the temporary file domain as 
$OLDPASS. If you do create your own program file, you must do so in one 
of two ways: 

• By using the MPE : BUILD command and specifying a file code of 1 029, 
or PROG, and a nutnextents value of 1. This file is then used by the 
: PREP command. 

• By specifying a nonexistent file in the progfile parameter, in which 
case a job/session temporary file of the correct size and type is created. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is FTNLIST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command ( FTNTEXT, 
FTNPROG, and FTNLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the MPE :FILE command. ' 



quotedstring 



A sequence of characters between two single quotation marks (apostrophes) 
or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is 
considered part of the string, and, therefore, not the terminating delimiter. 
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INFO=quotedstring is used in the FORTRAN/77 programming language to 
pass initial compiler options to a program. PASCAL/3000 brackets the 
quotedstring with dollar signs and places it before the first line of source 
code in the text file. For more information, refer to the : RUN command in 
this section. 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The :FTNPREP command compiles and prepares a FORTRAN/77 program into a program file on disc. If 
you do not specify textfile, MPE expects input from the current input device. If you do not specify listfile, 
MPE sends the listing output to the formal file designator FTNLIST (default $STDLIST). The USL file 
$0LDPASS, created during compilation, is a temporary file passed directly to the Segmenter. You may 
access it only if you do not use the default for prog file. This is because the Segmenter also uses $OLDPASS 
to store the prepared program segments, overwriting any existing temporary file of the same name. 

EXAMPLES 

The following example compiles and prepares a FORTRAN/ 7 7 program entered through your standard 
input device and stores the prepared program segments in the file $OLDPASS. The listing will be printed 
on your standard list device. 

rFTNPREP 

To compile and prepare a FORTRAN/77 source program from the source file FORTSRC, storing it in 
FORTPROG, and sending the listing to your standard list device, enter: 

: FTNPREP FORTSRC, FORTPROG 

ADDITIONAL DISCUSSION 

FORTRAN 77 Reference Manual (5957-4685) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:FULLBACKUP 



Performs a backup of MPE and all of the files on the system. 



SYNTAX 




PARAMETERS 

dump tape 
auxlistfile 



Specifies the magnetic tape destination for the backup. If dumptape is 
specified, it must be backreferenced to a previous :FILE command or the 
file equates to the formal file designator DUMPTAPE. The default is TAPE. 
If there is not a device class TAPE, the device class CTAPE will be used. 

Actual file designator of the output file (device) to which all listings 
requested during the execution of the backup process are written. The 
default is $STDLIST. 



USE 

This command may be issued from a Session or Job, but not in BREAK. It is Breakable (suspends 
execution). It requires System Manager (SM) or System Supervisor (OP) capability. 

OPERATION 

This command starts the backup process and copies MPE and all of the files on the system including any 
ACD's attached to the files . The two commands : PARTBACKUP and : FULLBACKUP provide an alternative 
to the :SYSDUMP dialog. The only user interaction required with these commands is mounting tapes or 
serial discs and replying to any mount request. These replies are unnecessary, however, if the devices are 
configured as AUTO REPLY. 

During the backup, : FULLBACKUP will display messages at one minute intervals to report its progress: 

STORE OPERATION IS 21% COMPLETE 



EXAMPLES 

In the following example the first :FILE command defines DUMP as a magnetic tape file. The second 
:FILE command defines LIST as a line printer. The TAPE and LP parameters are device class names 
arbitrarily defined during the previous system configuration. 

FILE DUMP;DEV=TAPE 
FILE LIST;DEV=LP 
FULLBACKUP *DUMP,*LIST 



OCT 1988 
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Establishes a logging identifier on the system. 



:GETLOG 



SYNTAX 



{|DISC } 



:GETLOG 



%QG=logfile[ 



|TAPE > 
,SDISC> 

;ctape} 



[|PASS=passj<torrf] 



[ 



{;AUTO } 
{?NOAUTO} 



PARAMETERS 

logid 

log file 

password 

AUTO 
NOAUTO 



The logging identifier to be established. This must contain from one to 
eight alphanumeric characters beginning with an alphabetic character. 

The name of the file to receive data from the logging procedure. It must 
contain from one to eight alphanumeric characters, beginning with an al- 
phabetic character. You must also specify the device class on which the log- 
file resides, i.e. DISC, TAPE, SDISC, or CTAPE. 

Logging identifier password, optionally assigned by the creator for protec- 
tion against illegal use of a particular identifier. The password must contain 
from one to eight alphanumeric characters, beginning with an alphabetic 
character. 

Initiates an automatic CHANGE LOG if the log file becomes full. Refer to 
:CHANGELOG in this section. 

Prevents initiation of an automatic CHANGELOG. A CHANGE LOG will not be 
performed if the log file becomes full. 



USE 

This command may be issued form a Session, Job, Program, or in BREAK. It is not Breakable. It requires 
System Supervisor (OP) or User Logging (LG) capability. 



I 



OPERATION 

The rGETLOG command specifies a logging identifier to be used each time a particular logging process is 
used. Frequently the :GETLOG command is used with data bases, so that each test task runs will write to a 
logging file. Therefore, data recovery is easier because you know where the task failed. 
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The creator of the logging identifier must have User Logging (LG) capability to execute this command. 
Other users can be allowed access to this logging identifier by notifying them of the identifier and pass- 
word. Note that if a password is specified, it will be required whenever the logging process is accessed. 
Users accessing the logging system with this identifier must supply the identifier and password in the 
OPEN LOG intrinsic. 

To use the AUTO parameter, the log process for log id must be enabled for changing. You may do this by 
ending the log file name with the numeric characters "001" (e.g. fnameOOl). This naming convention 
works in conjuction with the file set number to generate sequential filenames automatically. 

There cannot be two logging identifiers with the same name on the system at the same time. The 
: LISTLOG command can be used to find out what logging identifiers currently exist. 

EXAMPLE 

To create the logging identifier FINANCE and associate it with the disc log file A, enter: 
i GETLOG FI NANCE ;LOG=A, DISC 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
MPE V Intrinsics Reference Manual (32033-90007) 
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:GETRIN 



Acquires a global Resource Identification Number (RIN) and assigns a password to it. 

SYNTAX 



:GETRIN rinpassWord 



PARAMETERS 

rinpassWord Password of the intrinsic that locks the RIN. The password must contain 

from one to eight alphanumeric characters, beginning with an alphabetic 
character. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The :GETRIN command acquires a global RIN from the MPE RIN pool, typically during a session. You 
must assign an arbitrary password for the RIN, which aids in restricting its use to authorized users. You 
can then give this RIN and the associated password to cooperating users so that it can be locked and un- 
locked by them. For instructions on how to lock and unlock a RIN, and how to pass a RIN and its pass- 
word as intrinsic parameters, refer to the MPE V Intrinsics Reference Manual (32033-90007). 

Users who know the RIN and its password can use it in their programs (in jobs or sessions) until the user 
who acquired the RIN releases it with the :FREERIN command. The RIN acquired is always a unique, 
positive integer. The total number of RINs MPE can allocate is specified when the system is configured, 
but cannot exceed 1024. If all currently available RINs have been acquired by other users, MPE will 
reject your request and issue the message: 

RIN TABLE FULL 

In this case, you must wait until one of the RINs becomes available, or request that your System Manager 
raise the maximum number of RINs that can be assigned. 

EXAMPLE 

To acquire a global RIN and assign to it the password MYRIN, enter: 

: GETRIN MYRIN 
MPE responds with the RIN number assigned, for example: 

RIN: 1 
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ADDITIONAL DISCUSSION 

MPE V Intrinsics Reference Manual (32033-90007) 
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:GIVE 



Assigns a downed device to diagnostics. 

SYNTAX 



:GIVE Ideo 



PARAMETERS 

Ideo The logical device number of the downed device. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is ex- 
ecutable only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

This command gives control of the device specified by Idev to diagnostics so that no other process can ac- 
cess the device while diagnostic tests are in progress. Before the device can be given to diagnostics, it must 
first be taken offline with the : DOWN command, as shown in the example below. 

EXAMPLES 

To assign a downed device with logical device number 8 1 to diagnostics, enter: 

: DOWN 81 
: GIVE 81 
11:20/3/LDEV#81 IN USE BY DIAGNOSTICS 
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To assign a spooled job accepting card reader to diagnostics, enter: 

t STOPSPOOL 5 

11:16/31SP#5/ST0PPED 

11: 16/31 /LDEV#5 NOT READY 



** Stops spooling 

process for Idev 5. ** 



: REFUSE 5 



:ABORTIO 5 



11:16/3/LDEV#5 NO I/O PENDING 



** Prevents jobs and 

sessions on the device. ** 

** Aborts pending I/O 
for the device. ** 



:DOWN 5 



:GIVE 5 



11:16/3/LDEV#5 IN USE BY DIAGNOSTICS 



** Takes Idev 
5 offline. ** 

** Gives Idev 

5 to diagnostics. ** 
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:HEADOFF 



Stops header/trailer output to a device. 

SYNTAX 



: HEADOFF IdeO 



PARAMETERS 

Idev The logical device number of the printer or card punch affected by the 

command. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

Header and trailer information is the data which appears before and after a file, but which is not part of 
the file's text. It identifies the file by session number, output spoolf ile number, session name (if any), user 
and account. It also lists the date and time the file was printed. 

When the header/trailer facility is enabled and output is directed to a card punch, MPE automatically 
punches a header card and a trailer card identifying the job. If output is directed to a line printer, MPE 
automatically prints header and trailer pages identifying the job that produced the file. 

If the device is in use and a header has already been printed when you issue the : HEADOFF command, your 
request to suppress header/trailer output will take effect after the corresponding trailer is printed. 

EXAMPLE 

To stop header /trailer output to logical device number 6 , enter: 
: HEADOFF 6 
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:HEADON 



Resumes header/trailer output to a device. 

SYNTAX 



;HEADON IdeO 



PARAMETERS 

IdeO The logical device number of the printer or card punch affected by the 

command. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

Header and trailer information is the data which appears before and after a file, but which is not part of 
the file's text. It identifies the file by session number, output spoolf ile number, session name (if any), user 
and account. It also lists the date and time the file was produced. 

When the header/trailer facility is enabled and output is directed to a card punch, MPE automatically 
punches a header card and a trailer card identifying the job. If output is directed to a line printer, MPE 
automatically prints header and trailer pages identifying the job that produced the file. 

If the device is in use, your request to resume header/trailer output will take effect after the the current 
output is complete. 

The header/trailer facility is enabled on all cold loads. 

EXAMPLE 

To resume header/trailer output to logical device number 6 enter: 
:HEADON 6 
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:HELLO 



Initiates an interactive session. 



SYNTAX 



: HELLO [session ncuve^ ]username[iuserpass)§acctname[§acctpass] 
[§groupname [igrouppass] ] 



[iTER M 4J emt ^ e >] 
s {termname} 



[!||TIME=cp«secs ] 



{BS} 
rai P Ri-< cs >i 

<ES} 



r {;3i INPRI =i« put priority) , 
L <lHIPRI } J 



PARAMETERS 

sessionname 



user name 



user pass 



ace t name 



acctpass 



groupname 



Arbitrary name used in conjunction with username and acctname para- 
meters to form a fully qualified session identity. The name must contain 
from one to eight alphanumeric characters, beginning with an alphabetic 
character. Default is that no session name is assigned. 

Username, established by the Account Manager that allows you to logon 
under this account. The name must contain from one to eight alphanumeric 
characters, beginning with an alphabetic character. 

User password, optionally assigned by the Account Manager. The password 
must contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. The userpass parameter must be preceded by a slash 
(/)• 

Account name as established by the System Manager. The name must con- 
tain from one to eight alphanumeric characters, beginning with an al- 
phabetic character. The acctname parameter must be preceded by a period 
(.)- 

Account password, optionally assigned by the System Manager. The pass- 
word must contain from one to eight alphanumeric characters, beginning 
with an alphabetic character. The acctpass parameter must be preceded by 
a slash (/). 

Group name to be used for the local file domain and the CPU time charges 
as established by the Account Manager. The name must contain from one 
to eight alphanumeric characters, beginning with an alphabetic character. 



I 



I 
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grouppass 



termtype or 
termname 



Default is your home group if you are assigned one by the Account 
Manager. (Required if a home group is not assigned. ) 

Group password optionally assigned by the Account Manager. The password 
must contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. The grouppass parameter is not needed when you 
logon to your home group. The grouppass parameter must be preceded by 
a slash (/). 

Determines terminal-type characteristics. The termtype parameter whose 
assigned value determines the type of terminal used for input MPE uses 
this parameter to determine device -dependent characteristics such as delay 
factors for carriage returns. It must be a number from to 22. For more 
information refer to Appendix A "TERMINALS SUPPORTED BY MPE". 
The default value for termtype is assigned by the System Supervisor during 
system configuration. This is a required parameter to ensure correct list- 
ings if your terminal is not the default termtype. 

The termname parameter is the name of the file containing the desired 
terminal-type characteristics. The file cannot have a lockword or reside on 
a Private Volume. 



cpusecs 



Users of the Workstation Configurator are allowed to create terminal -type 
files. The proper and efficient operation of a specific device by a user 
created terminal -type is the responsibility of the user. The Workstation 
Configurator utility allows the user to specify the following characteristics 
of your terminal: data flow control, block mode, read trigger, special 
characteristics, echo, line feed, parity, and printer control. 

If group and/or account names are omitted, the proposed logon group 
and/or account name is substituted. For further information on the 
terminal-type characteristics, refer to the Fundamental Communications 
Handbook (5957-4634) and the Workstation Configurator Reference 
Manual (30239-90001). 

Maximum CPU time that session can use, entered in seconds. When the 
limit is reached, session is aborted. It must be a value from 1 to 32767, but 
cannot exceed any limit imposed by the System or Account Manager. To 
specify no limit, enter a question mark (?), UNLIM , or omit the parameter. 
Default is no limit. 



BS, CS, DS, or ES 



The execution priority queue that the Command Interpreter uses for your 
session, and also the default priority for all programs executed within the 
session. BS is highest priority, ES is lowest. If you specify a priority that 
exceeds the highest permitted for your account or username by the system, 
MPE assigns the highest priority possible below BS. DS and ES are intended 
primarily for batch jobs; their use for sessions is generally discouraged. 
Care should be use in assigning the BS queue because processes in this 
priority class may lock out other processes. For information on the 
guidelines for these priority queues, refer to the :TUNE command in the 
MPE V System Operation and Resource Management Reference Manual 
(32033-90005). Default is CS. 
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inputpriority or Determines the input priority of the job or session. The input priority op- 

HIPRI tion is the relative input priority used in checking against access restrictions 

imposed by the jobfence. The inputpriority option takes effect at logon 
time and must be from 1 (lowest priority) to 1 3 (highest priority). If you 
supply a value less than or equal to current jobfence set by System 
Operator, session is denied access. Default is 8. 

The HI PR I option is used for two different purposes when logging on. It 
can be used to override the system jobfence or it can be used to override the 
session limit. When using the HI PR I option to override the jobfence, the 
system will first check to see if you have System Manager (SM) or System 
Operator (OP) capability. If you have either of these capabilities, you will 
be logged on and your IN PR I will default to the system's jobfence and ex- 
ecution limit. If you do not have either of these capabilities, the system 
will attempt to log you on using INPRI = 13 and will succeed if the jobfence 
is 12 or less, and if the session limit is not exceeded. In attempting to over- 
ride the session limit (to logon after the maximum number of sessions set by 
the operator has been reached), you can specify HI PR I, but to do so you 
must have either SM or OP capability. The system will not override the the 
session limit automatically. Use of the HI PR I option without SM or OP 
capability causes the following warning to be displayed: 

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, 
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460) 



USE 

This command may be issued from a Session. It may not be used from a Job, Program, or in BREAK. It is 
Breakable.* 

* Pressing [break) during the output of the logon message terminates the rest 
of the message. You will remain logged on, and MPE will prompt you for 
your next command, provided you do not have an OPTION LOGON UDC. If 
there is an OPTION LOGON UDC that is not a program, the UDC is not 
BREAKable and is forced at logon time. 

OPERATION 

The : HELLO command initiates an interactive session and must be entered from a terminal; no other 
device can be used for this command. You must supply both a valid username and account name in your 
logon command. Otherwise, MPE rejects your logon attempt and prints an error message to that effect. 
If your logon attempt is accepted, however, MPE verifies this by printing specific logon information and 
prompting you for your next MPE command. This information appears in the following example, where a 
user has logged on under the username MAC and the account name TECHPUBS: 

: HELL0 MAC.TECHPUBS 

HP3000 / RELEASE: G.03.04 VERSION: G.03.04 TUE, MAY 31,1988, 10:16AM 

MPE V HP32033 G.03.04 COPYRIGHT HEWLETT-PACKARD 1984. ALL RIGHTS RESERVED. 



** MPE prompts for next command. ** 
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Sometimes a welcome message from the System Operator will appear following the MPE verification of 
your logon. 

The session number assigned by MPE uniquely identifies your session to MPE and to other users. MPE as- 
signs such numbers to sessions in sequential order as they are logged on. If you are on a modem and do 
not logon within the system configured time, the line is dropped. You must redial and press [return! again. 
If you are already logged on and you issue the : HELLO command, you will be logged off your current ses- 
sion and logged onto a new session except in the following cases: 

• Spaces precede the command. 

• The command is executed using a : REDO command. 

• The command is issued in a user defined command (UDC). 

In certain instances, you may be required to furnish information in addition to the user and account 
names in your : HELLO command or : ( ) COMMAND LOGON. This information includes: 

• Group Name. 

• One or more passwords. 

• Terminal type code. 

Group Name 

The group you select at logon for your local file domain is known as your logon group. If your Account 
Manager has associated a home group with your username, and if you desire this group as a logon group, 
you need not specify this. MPE automatically assigns the home group as your logon group when you 
logon. But if you desire to use some other group as your logon group, you must specify that group's name 
in your logon command in this way: 



: HELLO MAC.TECHP U BS , YGROU P 

** Group name ** 



If your username is not related to a home group, you must enter a group name in your : HELLO command 
or : ( ) COMMAND LOGON, or your logon attempt will be rejected. 

Once you logon, if the normal (default) file security provisions of MPE are in force, you have unlimited 
access to all files in your logon and home groups. Furthermore, you can read files and execute programs 
stored in the PUB (public) group of your account and the PUB (public) group of the SYS (system) account. 
You cannot, however, access any other files in any way. Further information about files and file security 
can be found in the MPE File System Reference Manual (30000-90236). 
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Passwords 

To enhance the security of an account, and to prevent unauthorized accumulation of charges against the 
account, the System Manager can assign an account password. Similarly, an Account Manager may as- 
sociate passwords with the user and groups belonging to the account. 

Sometimes, when logging onto the system, it is more convenient to have MPE prompt you for required 
passwords. You do this by omitting the passwords from the logon command. When you logon, MPE 
"prompts" you for the password. If you enter the password incorrectly, the prompt reappears and you will 
have two more chances to enter the password correctly. After the third incorrect attempt, MPE cancels 
the logon, and you must press [RETURN) to receive another prompt. Echo is turned on after all passwords 
are read. 

If you are using an account, username, or group (other than your home group) that has a password, you 
must furnish that password when you logon. Include the password after the name of the protected entity, 
separated from that name by a slash mark (/) or if omitted you will be prompted for them. In MPE, slash 
marks denote passwords. 

For instance, if the group XGROUP requires a password and if you wish this group as your logon group, you 
could enter the password in this fashion: 

** Group password ** 

■ HELU, M*C. TE CH P UBS.*Q B U P/XpL 

Note that when you specify your home group as your logon group, you need not enter a password, even if 
that group has such a password. 

If you have installed HP Security Monitor, your System Manager can require password prompts for your 
system. MPE does not accept embedded passwords (as in HELLO MAC.TECHPUBS,XGROUP/XPASS). If you 
enter an embedded password, MPE displays an error statement is displayed: 

PASSWORD PROMPTS ARE REQUIRED, EMBEDDED PASSWORDS ARE NOT ALLOWED. (CIERR 1449) 

Terminal Types 

MPE must be able to determine certain characteristics about your terminal, such as input and output 
speed, in order to conduct a session. If you logon using a different type of terminal than the type the 
System Manager has configured, you must specify your terminal type when you logon. For example, if 
you are logging on at an HP 2621 A, but the default type at your site is a HP 2645A you would enter: 

:HELLO MAC.TECHPUBS;TER M=10 

F 

** Terminal type ** 

Terminal types may also be specified as a file containing terminal-type characteristics. Users of the 
Workstation Configurator are allowed to create terminal type files without any restrictions. The proper 
and efficient operation of a specific device by a user -created terminal type is the responsibility of the 
user. For example, a terminal type that specifies no flow control mechanism will generally create data 
overruns on the device. Users may control each of the following terminal -type characteristics: echo, line 
feed during input, form feed during output, backspace response, printer control, and parity. Refer to the 
Workstation Configurator Reference Manual (30239-90001) and the Fundamental Communications 
Handbook (5957-4634) for more information. Refer also to Appendix A, "Terminals Supported by MPE", 
in Section III of this manual. 
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EXAMPLE 

To start a session named ALPHA, with the user MAC, the account TECH PUBS, the group XGROUP, and the 
grouppass word XPASS, enter: 

; HELLO ALPHA, MAC. TECHPUBS,XGROUP/XPASS 

HP3000 / MPE V G.03.00 (BASE G.03.00). MON, AUG 11 1986, 8:22 AM 

: ** MPE then prompts for next command. ** 
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:HELP 



Accesses the HELP subsystem. 



SYNTAX 



:HELP 
[HELP 

[tablecontents 
[ command [ keyword ] 
[ALL 
[EXIT 



PARAMETERS 

HELP 
tablecontents 



contnand 



Displays information for the : HELP command. This is treated the same as 
entering HELP with any other command, because : HELP is a command. 

Any of several items for which information may be obtained. These items 
are: 

SESSIONS 

JOBS 

PROGRAMS 

FILES 

MANAGE 

OPERATOR 

SPOOLER 

UTILITY 

If you want information on running sessions, you would enter: 

; HELP SESSIONS 

Any MPE command. MPE displays the command name and syntax. In ad- 
dition, a list of keywords for that command is displayed. 

Any UDC can also be the command. In this case MPE will list out the lines 
of the UDC from the UDC catalog file and reference the UDC as a "user 
defined command". 
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keyword 



ALL 



EXIT 



One of the keywords described under the command parameter. All com- 
mands have the following keywords: 



PARMS 

OPERATION 

EXAMPLE 

ALL 



Lists all parameters of the specified command. 

Describes the use of the specified command. 

Displays an example showing usage of the specified 
command. 

Displays all parameters, operation, and an example 
of the command. 



The : FI LE command has the following additional keywords: 

NAME 
DEVICE 
ACCESS 
DISP 

Entering the :HELP command, followed by a command name and the ALL 
parameter causes MPE to display all information for that command (syntax, 
parameters, operation, and example). The keyword parameter can be en- 
tered with a command, as in :HELP HELLO PARMS. In this case, PARMS is a 
keyword and must be separated from the command with a space or comma. 
The keyword parameter also can be entered alone, if you are running the 
HELP subsystem in subsystem mode, in response to the (>) prompt. 

Displays entire table of contents and the contents of each keyword for the 
: HELP command. 

Exits the HELP subsystem. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. 
execution). 



It is Breakable (aborts 



OPERATION 

The .HELP command accesses the HELP subsystem. If entered with no parameters, as in 

:HELP 

HELP enters the subsystem mode, displays a table of contents and greater -than (>) prompt, and awaits 
your input. Entering any table of contents item such as SESSIONS produces a listing of all the the com- 
mands used in running sessions. Entering any command name produces the syntax for that command and 
a list of the keywords. Entering a keyword such as PARMS produces a listing of all the items for that 
keyword (all parameters in this case). 
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Entering E or EXIT or pressing 1BREAKI terminates the HELP subsystem. Entering Y c terminates the 
display, and returns you to a system prompt. Entering S c temporarily stops the display, and entering Q C 
resumes the display (useful if the screen is full as when using a CRT terminal). Pressing [return] in sub- 
system mode causes MPE to display information up to the next keyword or command. For example, after 
you enter STORE with the :HELP command, MPE displa ys STOR E syntax, the keyword list (PARMS, 
OPERATION, EXAMPLE) and provides a prompt (>). Pressi ng (RETDrnI again causes MPE to display all pa- 
rameter information for the : STORE command. Pressing [RETURN1 again at the next prompt causes MPE to 
display all OPERATION information for the : STORE command. (This is similar to turning the pages of a 
manual. ) 

Entering :HELP with a parameter causes HELP to enter the immediate mode. Information pertaining to 
that parameter is displayed immediately. For example: 

; HELP ABORT 

Causes HELP to display: 

: ABORT 

Aborts current program or operation. 

SYNTAX 

: ABORT 

KEYWORDS : PARMS , OPERATION , EXAMPLE 



EXAMPLE 

To obtain information concerning MPE utility functions, enter: 
:HELP UTILITY 



MPE displays: 




Utility Functi 


tons. Followin 


CONSOLE 


SHOWALLOW 


PTAPE 


SHOWCATALOG 


SETCATALOG 


SHOWME 


SETMSG 


SHOWTIME 


SPEED 


TELL 


RECALL 


TEL LOP 


REDO 





You can use any command name as a keyword. 



KEYWORDS: SESSIONS, JOBS, PROGRAMS, FILES, MANAGE .OPERATOR, SPOOLER, 
UTILITY 
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:IF 



Used to control the execution sequence of a job. 



SYNTAX 



:IF [{]logexpr[)] THEN 



PARAMETERS 

logexpr 



Logical expression, consisting of the operands and relational operators. The 
relational operators allowed are: 

> greater than 

< less than 

>= greater than or equal 
<= less than or equal 
= equal 

< > not equal 

The allowed operands are: JCW or CI ERROR; any Job Control Word values 
saved in a name with the : SETJCW command; OK, WARN, FATAL , or SYSTEM 
(as defined under the : SETJCW command), or integer constants. 

Compound logical expressions can be formed using the AND and OR logical 
operators, and nested within parentheses. 



USE 

This command may be issued from a Session, Job, or in BREAK. It may not be used from a Program. It is 
not Breakable. 

OPERATION 

This command begins an IF block consisting of all the commands after the :IF command up to, but not 
including, the next :ELSE or :ENDIF statement. The :ELSE or :ENDIF must have the same nesting level 
as the IF statement. Another similar block can follow the :ELSE statement. Nesting of the blocks is al- 
lowed to 1 5 levels. The : ENDIF statement ends the IF block. 

The logical expression is evaluated and, if the expression evaluates to true, the IF block is executed; if false, 
the ELSE block (if one exists) is executed. 
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EXAMPLE 

The following job listing illustrates the use of an : IF statement with : ELSE and : ENDIF statements: 

•CONTINUE 
!SPL MYPROG.MYUSL 
IF JCW>=FATAL THEN 

TELL MAC.TECHPUBS;COMPILE FAILED 
ELSE 

TELL MAC.TECHPUBS;COMPILE COMPLETED 
ENDIF 
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:JOB 



Initiates a batch job. 

SYNTAX 



: JOB [ jobname* ] username [§userpass] pacctname 
[§acctpass] [i$roupname\Mgrouppass] ] 

[§TIME=cpwsees] 

<BS> 
r; ipRI _<CS> . 
l " PRI <DS> J 

<ES> 



r {|IN PRI Hnputpriori ty } , 

1 {|hipri } j 

[irestart] 

[|OUTCLASS= [deo ice] \Moutputpriority[unumcopies] ] ] 

[lTERM=<J emt ^>] 
l *- {termname} 1 



PARAMETERS 

jobname 



username 



userpass 



acctname 



acctpass 



Arbitrary name used with username and acctname parameters to form a job 
identity. The name must contain from one to eight alphanumeric charac- 
ters, beginning with an alphabetic character. Default is that no job name is 
assigned. 

Username, established by the Account Manager, that allows you to logon 
under this account. The name must contain from one to eight al- 
phanumeric characters, beginning with an alphabetic character. 

User password, optionally assigned by Account Manager. The password must 
contain from one to eight alphanumeric characters, beginning with an al- 
phabetic character. 

Account name as established by the System Manager. The name must con- 
tain from one to eight alphanumeric characters, beginning with an al- 
phabetic character. The acctname parameter must be preceded by a period 
(.)• 

Account password, optionally assigned by the System Manager. The pass- 
word must contain from one to eight alphanumeric characters, beginning 
with a alphabetic character. The acctpass parameter must be preceded by 
a slash (/). 



2-172 



groupname 



Group name to be used for the local file domain and for CPU time charges, 
as established by Account Manager. The name must contain from one to 
eight alphanumeric characters, beginning with an alphabetic character. 
Default is home group if one is assigned. (Required if a home group is not 
assigned. ) 



grouppass 



Group password, optionally assigned by Account Manager. The password 
must contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. The grouppass parameter is not needed when you 
logon to your home group. The grouppass parameter must by preceded by 
a slash (/). 



cpusecs 



BS, CS, OS, or ES 



Maximum CPU time allowed job, in seconds. When this limit is reached, 
job is aborted. This must be value from 1 to 32767. To specify no limit, 
enter a question mark or UNLIM, or omit this parameter. Default is system 
configured job limit. 

The execution priority queue that the Command Interpreter uses for your 
session. This is also the default priority for all programs executed within 
the session. BS is highest priority, ES is lowest. If you specify a priority 
that exceeds the highest permitted for your account or username by the sys- 
tem, MPE assigns the highest priority possible below BS. DS and ES are in- 
tended primarily for batch jobs; their use for sessions is generally 
discouraged. 



CAUTION 



Use care in assigning the BS queue. Processes in this priority 
class can lock out other processes. 



input priority or 
HIPRI 



For information on the guidelines for these priority queues, refer to the 
:TUNE command in the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). Default is CS. 

Determines the input priority of the job or session. The inputpriority op- 
tion is the relative input priority used in checking against access restrictions 
imposed by the job fence. The inputpriority option takes effect at logon 
time and must be from 1 (lowest priority) to 1 3 (highest priority). If you 
supply a value less than or equal to current job fence set by System 
Operator, session is denied access. Default is 8. 



HIPRI is the request for maximum input priority, causing job to be 
scheduled regardless of current job fence or execution limit for jobs. This 
parameter overrides the inputpriority. You can specify this parameter only 
if you have System Manager or System Supervisor capability. If not, the 
system tries to log you on with INPRI=13. 



RESTART 



Request to restart a spooled job that has been interrupted by system ter- 
mination/restart. This parameter takes effect automatically when system 
is subsequently restarted with the WARMSTART option. 
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device 



This parameter applies only to jobs initiated on spooled input devices. It is 
ignored for other jobs. Default is that spooled jobs are not restarted after 
system termination/restart. 

Class name or logical device number (Idev) of device to receive listing out- 
put. You cannot specify a magnetic tape unit. If the parameter is not a 
valid Idev or class name an error will be generated. Default is defined in 
the system configuration. 



NOTE 



Nonsharable device (ND) file access capability is required in 
order to use this parameter. 



output priority 



numooptes 



termtype or 
ternmame 



The output priority for job list file, if destined for spooled line printer or 
card punch. This parameter is used to select next spooled devicefile (on 
disc) for output, among all those contending for a specific printer or punch. 
Must be a value from 1 (lowest priority) to 13 (highest priority). Note that 
when the out put priority is 1, output is always deferred. Thus, you should 
use an outputpriority of 2 or greater if you wish output printed or punched 
from disc. 

This parameter applies only to output destined for spooled output devices, 
and is ignored for other output. Default is 8. 

Number of copies of job listing to be produced. This parameter applies only 
when listing is directed to a spooled device, and is ignored in other cases. If 
the number of copies is less than 1 a warning will be issued. The command 
will still execute with the default value of 1. If it is greater than 127, an 
error message will be printed and 1 27 copies will be printed. Default is 1. 

Determines the terminal-type characteristics. The termtype parameter 
determines the type of terminal used for input. MPE uses this parameter to 
determine device dependent characteristics such as delay factors for car- 
riage returns. It must be a number from to 22. Refer to Appendix A 
"TERMINALS SUPPORTED BY MPE V" for a list of terminal -type num- 
bers. The default value for termtype is assigned by the System Supervisor 
during system configuration. This is a required parameter to ensure correct 
listings if your terminal is not the default termtype. 

The termname parameter is the name of the file containing the desired 
terminal-type characteristics. The file may not have a lockword or reside 
on a Private Volume. 

Users of the Workstation Configurator are allowed to create terminal-type 
files. The proper and efficient operation of a specific device by a user- 
created terminal-type is the responsibility of the user. The Workstation 
Configurator utility allows the user to specify the following characteristics 
of your terminal: data flow control, block mode, read trigger, special 
characteristics, echo, line feed, parity, and printer control. 
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If group or account names are omitted, the proposed logon group and/or ac- 
count name is substituted. For further information on the terminal -type 
characteristics, refer to the Fundamental Communications Handbook 
(5957-4634) and the Workstation Configurator Reference Manual 
(30239-90001). | 



USE 

This command may be issued from a Session or Job. It may be used from a Program or in BREAK. It is 
not Breakable. 

OPERATION 

Initiates a batch job by establishing contact with MPE. If the job is initiated through a session and is in 
WAIT state, your terminal is locked until the job enters EXEC state. When MPE begins the job, it displays 
the following information on the list device: 

• Job Number, as assigned by MPE, to identify the job. 

• Date and time. 

• "HP 3000", and the modified and base MPE version.update.fix numbers. 

In the : JOB command, as in the : HELLO command, you must always include your username and account 
name, which you obtain from your Account Manager. If you omit either of these names, or enter them 
incorrectly, MPE rejects your job and prints an error message on the standard listing device. If your job is 
accepted, MPE begins job processing. If the job is entered through a spooled input device, the job is copied 
to a disc file and initiated from that file rather than the originating device. 

If the standard listing file is a line printer, MPE prints a a header page prior to listing the : JOB command. 
(The System Operator can disable the printing of this page via the console command : HEADOFF.) 

The job number assigned by MPE always uniquely identifies your job to MPE and other users. MPE as- 
signs such numbers in sequential order as jobs are accepted. 

Sometimes, the job acceptance information includes a message from the System Operator following the 
standard display. When present, this is the same message output in the logon information for sessions. 

The minimum information needed for job initiation is the user and account name. Under certain cir- 
cumstances, however, you may need to furnish the following additional information in your :J0B 
command: 

• File Group Name. 

• User, Account, and/or Group Passwords. 

The cases in which this information is required, and the rules for supplying it, are the same as those for 
the : HELLO command for sessions, except that: 

• When you omit a required password from the :JOB command, MPE rejects your access attempt 
without prompting you for the password. 

2-175 AUG 1986 



• When you enter the : JOB command through a device other than a terminal and the standard input 
device is different from the standard listing device, MPE does not echo passwords. 

• When the standard listing device is a line printer, and you do not specify a file group name, central 
processor time limit, execution priority, and/or input priority in the :JOB command, the default 
values assigned by MPE for the omitted parameters appear on the job listing. 

A job will execute user defined commands (UDCs) whether the job is interactive or streamed. UDCs will 
also execute in any subsystem or in MPE itself. You or your stream files must anticipate actions, prompts, 
or questions incorporated in any UDC you use, whether you use it interactively or in a streamed job. 

The : EOJ command is used to terminate or end a job. The only alternative exits from a job are an error 
flush or an ABORT. An error flush stops the completion of the job at the point the error occurred. 

EXAMPLE 

To start a job named BETA, with the username MAC, acctname TECH PUBS, groupname XGROUP, and group- 
pass XPASS, enter: 

: JOB BETA, MAC. TECHPUBS.XOROUP/XPASS 

JOB NUMBER = #J1 

MON, MAY 14, 1985, 8:22 AM 

HP3000 / MPE V G.02.00 (BASE G.02.00) 



ADDITIONAL DISCUSSION 

MPE File System Reference Manual (30000-90236) 
MPE V Intrinsics Reference Manual (32033-90007) 
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:JOBFENCE 



Defines the minimum input priority that a job or session must have in order to execute. 

SYNTAX 



: JOBFENCE priorityfence 



PARAMETERS 

priorityfence A number between and 14, inclusive. Within this range, smaller 

numbers are less limiting; larger numbers more limiting. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

MPE will not dispatch jobs or sessions with an input priority less than or equal to the priorityfence until 
their input priority is raised with the :ALTJOB command, or until the JOBFENCE is lowered. System 
Managers and System Supervisors may override the JOBFENCE setting by logging on with the ;HIPRI 
parameter of the : JOB or : HELLO commands. Or, they may logon with an input priority greater than the 
JOBFENCE as reported by the rSHOWJOB command. 

EXAMPLES 

To defer all non-HI PR I jobs and sessions, first set the JOBFENCE to 1 4, as shown below. 

: JOBFENCE 14 

16:18/#J7/34/DEFERRED JOB INTRODUCED ON LDEV #10 

16:18/#J8/35/DEFERRED JOB INTRODUCED ON LDEV #10 

Then enter the : SHOWJOB command to display the effect of the new JOBFENCE. 

: SHOW JOB 

JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 

#S26 EXEC 20 20 THU 4:17P OPERATOR. SYS 

#J7 WAIT D8 10S 12 THU 4:18P JOB1 , FIELD. SUPPORT 

#J8 WAIT D8 10S 12 THU 4:18P J0B2, FIELD. SUPPORT 
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3 JOBS: 

INTRO 

2 WAIT; INCL 2 DEFERRED 

1 EXEC; INCL 1 SESSIONS 
SUSP 

JOBFENCE= 14; JLIMIT= 5; SLIMIT=16 

Finally, reset the JOBFENCE to 6, which will allow waiting jobs to logon. 

; JOBFENCE 6 

16:21/#J7/34/L0G0N FOR: J0B1 .FIELD. SUPPORT ON LDEV #10 
16:21/#J8/35/L0G0N FOR: JOB2, FIELD. SUPPORT ON LDEV #10 
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:JOBPRI 



Sets or changes the default execution priority for batch jobs and 
batch jobs. 

SYNTAX 



sets a maximum execution priority for 



: JOBPRI [maxsubqueue] \Jgdefdultsubqueue] 



PARAMETERS 

maxsubqueue 

defaul t subqueue 



The maximum priority at which batch jobs will be allowed to run. This 
overrides of any job priority a user may have requested with the :JOB 
command. This parameter may be ES , DS , CS , or . If is specified, no 
limit is imposed on batch jobs. Default is no change in maximum priority. 

The default execution priority for batch jobs, which may be ES , DS , or CS . 
This takes effect if a user does not specify an execution priority in the : JOB 
command. Default is no change in execution priority. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. Users must 
have OP capability to execute this command. 

OPERATION 

The maxsubqueue parameter specified in the : JOBPRI command takes precedence over defaultsubqueue. 
Therefore, selecting a default parameter greater than the value of maxsubqueue parameter will not affect 
job execution: jobs will still be initiated with the maximum priority parameter. 

EXAMPLE 

To raise the maximum execution priority so that batch jobs can run in any subqueue requested, enter: 
: JOBPRI 
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:JOBSECURITY 



Designates what level of user may request resources and control the execution of jobs. 

SYNTAX 



:JOBSECURITY \^ H \ 



PARAMETERS 

HIGH Permits only the Operator logged on at the Console to use job control 

commands. 

LOW Allows individual users to exercise control over their own jobs. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only from the Console. * 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

: JOBSECURITY controls the use of the : ABORTJOB , : ALTJOB , BREAKJOB , and :RESUMEJOB commands. 
The HIGH parameter permits only the Operator to issue these commands. JOBSECURITY LOW allows any 
user to issue these commands for their own jobs; the job's username and account must match that of the 
user. Account Managers do not need a matching username, so they may control the execution of any job 
in their account. 

EXAMPLE 

To allow any user to abort, alter, BREAK or resume their own jobs, enter: 
: JOBSECURITY LOW 
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LDISMOUNT 



Performs the logical dismount of a private volume set or class. 

SYNTAX 



: (.DISMOUNT ocsname. group. account 



PARAMETERS 

Ocsname Volume class/set name for which you are requesting a logical dismount. 

group. account The group and account under which the volume set was created. 

USE 

This command may be issued from a Session, Job, Program or in BREAK. It is not Breakable. It may be 
executed only from the Console. * 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

: LDISMOUNT is used to dismount Nonsystem Domain discs while the disc system is online. It informs MPE 
that the volume class/set is no longer needed and that member volumes should be logically dismounted, as 
a unit, from the drive(s) on which they reside. The dismount request will remain pending until any files 
being accessed on the disc volume are closed; at that point the command will execute. If the specified 
volume class/set is not mounted when you attempt to logically dismount it, you will receive an error 
message. 

EXAMPLE 

To dismount a private volume set named DATABASE, which was created in the PAYROLL group of the 
ACCTNG account, enter: 

; LDISMOUNT DATABASE . PAYROLL . ACCTNO 

ADDITIONAL DISCUSSION 

Refer to the discussion of "PRIVATE VOLUMES" in Section of the MPE V System Operation and 
Resource Management Reference Manual (32033-90005). 
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LIMIT 



Limits the number of concurrently running jobs/sessions. 

SYNTAX 



{numberjobs } 

: LIMIT {^numbersessions } 

{number jobs§riumbersessions} 



PARAMETERS 

numberjobs The number of jobs. 

numbersessions The number of sessions. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

Maximum job and session limits are established by the System Supervisor during system configuration. 
Within these limits, the Operator may redefine the job and session limit with the : LIMIT command. 
When the system is restarted from disc in a WARMSTART, the Operator defined limits are retained. 
When any other startup option is used, the values configured by the Supervisor take effect. 

At least one parameter must be included in the : LIMIT command. If you execute the : LIMIT command 
without parameters, the following message is displayed on the Console: 

EXPECTED ONE OF JOB OR SESSION LIMIT. (CIERR 3071) 

If you enter one parameter and omit the other, the limit of omitted parameter's remain unchanged. 

No new jobs or sessions will be dispatched that would cause either of these limits to be exceeded, unless 
they are initiated with the ;HIPRI parameter of the : JOB or :HELL0 commands. Non-HIPRI jobs can 
still be introduced when the limit is achieved, but they will not execute. 

If you attempt to logon to a non-HIPRI session after the limit has been reached, you will receive the 
message: 

CAN'T INITIATE NEW SESSIONS NOW 

The specified limits may be exceeded at the time the command is issued. This will not cause jobs or ses- 
sions executing at the time to abort. They will continue to execute, but no new jobs will be allowed to en- 
ter the executing state, and no new sessions will be initiated. 
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EXAMPLES 

To limit the number of jobs to 2 and the number of sessions to 1 5 , enter: 

; LIHIT 2,15 
:SHOWJOB 



JOBNUM STATE IPRI JIN JLIST 

#S24 EXEC 20 20 

#S26 EXEC 177 177 

#S96 EXEC QUIET 35 35 



INTRODUCED JOB NAME 

TUE 1 : 54A OPERATOR . SYS 

TUE 5: 01 A CHEWY, RSPOOL. SYS 

TUE 8:31A SLIDES. SIMON 



3 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

3 EXEC; INCL 3 SESSIONS 

SUSP 
JOBFENCE* 6; JLIMIT= 2; SLIMIT= 15 

To limit the number of sessions to 1 3, but retain the current job limit, enter: 

: LIMIT ,13 
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:LISTACCT 



Lists the attributes for one account (Account Manager capability) or for any or all accounts (System 
Manager capability). 

SYNTAX 



:LISTACCT [/ a< jJ t vl \MHstfile] 



PARAMETERS 

§ Specifies all accounts. This is the default for users with SM capability, 

which is required to list all accounts. 

acct The name of the account whose attributes are to be listed. Account 

Managers may specify only their own account. Default is the logon 
account. 

Note that the characters @, #, and ? can be used as "wildcard" characters, but will count toward the eight 
character limit. These "wildcard" characters have the following meanings: 

@ Specifies zero or more alphanumeric characters and denotes all members of 

the set. 

# Specifies one numeric character. 

? Specifies one alphanumeric character. 

The characters can be used as follows: 

n€ List all accounts starting with the character "n". 

§n Lists all accounts ending with the character "n". 

n@x Lists all accounts starting with the character "n" and ending with the 

character "x". 

n## . . . # Lists all accounts starting with the character "n" followed by up to seven 
digits. 

?n@ Lists all accounts whose second character is "n". 

n? List all two -character accounts starting with the character "n". 

?n List all two -character accounts ending with the character "n". 

listfile Destination of the attribute listing. The default is $STDLIST, but the out- 

put may be redirected with the :FILE command. 
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USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. Users must 
have System Manager (SM) or Account Manager (AM) capability to execute this command. 

OPERATION 

This command lists the attributes for one account (AM capability) or for one or all accounts (SM capability). 

The listing appears as an octal dump of the account entry; each is headed by "A = " and the account name. 
When the dump contains alphanumeric data, a translation into ASCII appears to the right of each line. 
The following is a sample listing of an octal dump: 



A = SYS 

051531 051440 020040 020040 
000000 000000 020040 020040 
077777 177777 000010 113257 
077777 177777 004551 140036 



000006 000007 177607 000713 SYS 

020040 020040 000010 052150 Th 

077777 1 77777 000037 1 47337 

000123 000217 i...S.. 



Each octal word in the preceding listing is displayed in the following decimal representation of the dump. 
The table on the next page decodes the information. 



CO- 


—01 — 


—02— 


—03— 


—04— 


—05— 


--06— 


--07 


OS— 


--09— 


— 10— 


— 11 — 


— 12— 


— 13— 


— 14— 


--15 


16— 


— 17— 


— 18— 


— 19 — 


—20 — 


—21 — 


—22— 


--23 


24— 


—25— 


—26— 


—27— 


—28— 


—29— 







WORDS 


CONTENT 


0-3 


Account name. 


4-5 


Account's group and user index pointers. 


6-7 


Account attributes. 


8-9 


Local attributes. 


10-13 


Password - encrypted. 


14-15 


Permanent file space usage count (in sectors). 


16-17 


Permanent file space limit (in sectors). 


18-19 


Central processor time usage count (in seconds). 


20-21 


Central processor time limit (in seconds). 


22-23 


Connect -time count (in minutes). 


24-25 


Connect -time limit (in minutes). 


26 


Purge and account -security flags. 


27 


Maximum job/session priority (numerical). 


28 


Command file location of account UDCs. 


29 


Command file location of SYS account UDCs. 



I 
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EXAMPLE 

To list the attributes of the account, SYS ,enter: 

: LISTACCT SYS 
A = SYS 

051531 051440 020040 020040 000006 000007 177607 000713 SYS 

000000 000000 020040 020040 020040 020040 000010 052150 Th 

077777 177777 000010 113257 077777 177777 000037 147337 

077777 177777 004551 140036 000123 000217 i...S.. 
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:LISTEQ 



Displays all active :FILE equations for a job or session. 

SYNTAX 



LISTEQ [listfile] 



PARAMETERS 

listfile The file to which output is directed. Default is $STD LI ST. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable. 

OPERATION 

The : LISTEQ command displays all the active : FILE equations for a job or session. 

EXAMPLE 

An example of : LISTEQ is given below. 
: LISTEQ 

**«FILE EQUATIONS 

FILE TAPE1;DEV=ATAPE 

FILE PP;ENV=LP2.ENV.0SE;DEV=EP0C 
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:LISTF 



Lists descriptions of one or more permanent disc files. 

SYNTAX 



LISTF [/iZ«setnj*g hlilistfile] 

{1-1} 
{,-2} 



PARAMETERS 

fileset Specifies the set of files to be listed. This positional parameter has the 

form: 

fi I ename [ . groupname [ . ace t name ] ] 

The characters 6, #, and ? can be used as "wildcard" characters in any posi- 
tion of the fileset parameter. The wildcard characters count toward the 
eight character limit for group, account, and filenames. These wildcard 
characters have the following meanings: 

% Specifies one or more alphanumeric characters. When 

used by itself, @ denotes "all members of the set". 

# Specifies one numeric character. 

? Specifies one alphanumeric character. 

These characters can be used with files as follows: 

n@ Lists all files starting with the character "n". 

§n Lists all files ending with the character "n". 

r\@x Lists all files starting with the character "n" and ending 

with the character "x". 

n####### Lists all files starting with the character "n" followed 

by seven digits. 

?n§ Lists all files whose second character is "n". 

n? Represents all two-character files starting with the 

character "n". 

?n Represents all two-character files ending with the 

character "n". 
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Note that depending upon the placement of these characters in the fileset 
parameter, they can also be used to indicate groups and accounts. If you 
specify nothing for the group or account, MPE assumes the logon group and 
account. Default is @ (lists all files in logon group). 

0, 1, 2, -1, or -2 Displays information about the file or Access Control Definitions (ACDs) 

associated with it. 

Displays only the filename. Default is if no listlevel is specified. 

1 Displays the filename, file code, record size, format, the current end-of-file 

location, and the maximum number of records allowed in the file. It also 
shows whether the file is ASCII or binary; CCTL or NOCCTL; CIR, MSG, or 
STD). An asterisk following the filename indicates that someone has 
FOPENed it and not yet done an FCLOSE. 

2 Displays all of the information found with the 1 option, plus the blocking 

factor, the number of disc sectors in use (including those in use for system 
and user labels), the number of extents currently allocated, and the maxi- 
mum number of extents allowed. 

- 1 Displays the octal listing of the file label. The first line of this listing is the 

directory entry for the file being listed. The remainder is the file label. 
The - 1 option is available only to users who have System Manager (SM) or 
Account Manager (AM) capability. 

-2 Displays the Access Control Definition (ACD) information associated with 

the requested fileset. If no ACD information exists for a file or if you 
do not have access to the ACD (System Manager, Account Manager, creator, 
or RACD access) a message stating that fact will be issued. 

listfile The name of the output file to which the descriptions are written. It is au- 

tomatically specified as an ASCII file with variable length records and these 
characteristics: closed in the temporary domain, CCTL (user supplied 
carriage -control characters), OUT access mode, and EXC (exclusive access) 
option. The remainder of its characteristics are those obtained with the 
:FILE command default specifications. This file is temporary and cannot 
be overwritten by a : BUI LD command. The default is $STDLIST. 



USE 



CAUTION 



When you specify 0, 1, 2, -1, or -2 the System Directory 
may be locked for a brief time, so no other users will be able 
to access the System Directory. 



This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts 
execution). 
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OPERATION 

This command lists descriptions of one or more disc files at the level of detail you select. You need not 
have access to a file to list a description of it. You must have access to a file to receive information on 
any associated Access Control Definitions. However, a file description will not be listed unless the file's 
home volume set (PV) is mounted. A standard user may list level 0, 1, and 2 information for any file in 
the system or -2 ACD data for those files for which they have read ACD access. Users with Account 
Manager capability may list level -1 or -2 data for files in their own account. A user with System 
Manager capability may list -1 or -2 data for any file in the system. 

Doing a : LISTF to the line printer or magnetic tape will print the date and time at the top. 

Note that this command applies only to permanent disc files. 

You may request that the file information be displayed on devices other than the standard listing device. 
Name the desired device in the :FILE command as follows: 



i FILE PRTR;DEV=LP 
:LISTF @.g,2;»PRTR 



** Equates name PRTR with device class name LP. ** 
** Direct level 2 description of all files in all groups of 
logon account to PRTR. ** 



If MPE fails to locate a requested file, the following error will be displayed: 

NON-EXISTENT FILE (CIERR 907) 

If you have a wildcard character in your request, and MPE cannot locate any files satisfying those condi- 
tions, the following warning is displayed: 

NO FILES FOUND IN FILE-SET (CIWARN 431) 

EXAMPLES 

The following examples illustrate several uses of the : LISTF command. 

Level (Default) Output Format 

: LISTF 



FILENAME 












APPB 


APPC 


APPD 


APPE 


APPF 


CONMSG 


C0N0P1 


CON0P4 


C0N0P5 


CONOPEX 


CONSG 


EXAMPLES 


GIMAGE 


GIHCOM 


GIMDOC 


GIMDS 


GIMPO 


INDEX 


K1013095 


LINDA 


LIST 


LOGON 


MEMO 


MTS 


MTS3000 


OPFRONT 


PS 


REPLY 


SCHED 


VIP 
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Level 1 Output Format 



:LISTF,1 














ACCOUNT= 


LEWIS 


GROUP= 


PUB 






FILENAME 


CODE - 






LOGICAL RECORD- 














SIZE 


TYP 




EOF 


LIMIT 


C0N0P1 




80B 


FA 




10 


10 


K0880909 


TDPQ 


104B 


FA 




636 


2269 


BOXES 


DRAW 


128W 


FB 




84 


84 


EXAMPLES 




80B 


FA 




20 


20 


ERRORLOG 




80B 


FAO 




12 


1024 



Level 2 Output Format 



:LISTF,2 
















ACCOUNT= 


USERS 


GROUP= 


BARBARA 








FILENAME 


CODE - 






LOGICAL RECORD- 






SPACE 






SIZE 


TYP 


EOF 


LIMIT 


R/B 


SECTORS #X MX 


APPB 




88B 


FA 


414 


414 


16 


162 14 14 


APPM 




80B 


VAM 


119 


240 


16 


12 8 8 


APPC 




80B 


FAO 


127 


208 


16 


70 8 8 


APPK 


KSAM 


80B 


FA 


16 


200 


16 


20 2 7 



The column headings in the example for : LISTF,2 have the following meanings: 



HEADING 

FILENAME 

CODE 

SIZE 
TYP 



MEANING 

Gives the filename. An asterisk (*) following the filename in the 1 
and 2 option indicates the file is open for READ or WRITE access. 

Refer to the : BUILD or :FILE command for an explanation of the 
file code. 

The size of the records in words (W) or bytes (B). 

The first letter under this heading contains information concerning 
record format. This will be listed in one of the following ways: F 
(fixed length), V (variable length), or U (undefined length). 

The second letter indicates whether the file is A (ASCII) or B (binary). 
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HEADING MEANING 

The third letter indicates the kind of file. This information will ap- 
pear in one of the following ways: Blank (Standard file unless KSAM 
appears in the code field.), (circular file), M (message file), or R (rela- 
tive I/O file). 

The letter "C" will follow if the file has the CCTL attribute. 

EOF End of file location. 

LIMIT Maximum number of records allowed. 

R/B Blocking factor. 

SECTORS Sectors in use. 

#X Extents allocated. 

MX Maximum number of extents allowed. 



Level -1 Output Format 



; LISTF UDCS, -1 
F = UDCS 

052504 041523 020040 020040 001001 120353 UDCS 

052504 041523 020040 020040 041517 046504 020040 020040 UDCS C0MD 

045440 020040 020040 020040 046501 051111 051523 040440 K TECH. 

020040 020040 020040 020040 020202 004040 000001 123525 U 

123525 123525 000000 000000 000014 000000 000000 002163 .U.U s 

000000 000000 120173 021427 000005 177650 002374 005015 

000024 000036 000000 002163 001001 120353 000400 104644 s 

001401 032743 001001 162503 001401 036363 001401 041324 ..5 C B. 

001001 164214 001401 042166 001002 001740 001401 044134 Dv H. 

001002 002656 001401 045323 001002 006740 000400 150014 J 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 000000 000000 000000 000000 

000000 000000 000000 000000 004072 034411 123525 000000 9..U.. 

000000 000000 000000 000000 000000 000000 004073 002010 

000000 000000 000000 000000 042111 051503 020001 000001 DISC 
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A pictorial explanation of the level - 1 output follows: 
; LISTF filename, -1 

F = filename 

File Name (4 words-octal) Sector address of label 

i 1 

Disc Volume 
Number 

(Bits 0:8) 
I 

m 



Beginning of octal File Label (Word 0) 






| 00 | 01 02 03 04 | | 05 | 


06 


07 




08 09 10 11 12 13 


14 


15 



Level -2 Output Format 



:LISTF, -2 
ACC0UNT= TEST 
FILENAME 
APPE 



N0ACCESS 
NONE 



GROUP* STGAMES 
ACD ENTRIES- 



JOE. DOE : R 

e.OSE : R,W,A,L,X 

e.e : x 

NO ACD ACCESS 
NO ACDS 
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The disc file label contains the following: 
WORDS CONTENTS 



0-2 


1 




Local filename. 


4-/ 


l 




Group name. 


8-11 




Account name. 


12- 


■15 




Identity of file creator. 


16- 


■19 




File lockword. 


20- 


•21 




File security matrix. 


22 




(Bits 0:7) 


Reserved for NLS. 






(Bits 8:13) 


Not used. 






(Bits 14:1) 


Store/Restore release bit. 






(Bits 15:1) 


File secure bit: 

If 1, file secured. 
If 0, file released. 


23 






File creation date. * 


24 






Last access date. * 


25 






Last modification date. * 


26 






File code. 


27 






Private Volume Information. 






(Bits 0:1) 


Class flag bit. 






(Bits 1:3) 


Not used. 






(Bits 4:4) 


Mounted volume table index. 






(Bits 8:8) 


Volume mask. 


28 




(Bit 0:1) 


Store BIT. (If on, : STORE or .-RESTORE, in progress.) 






(Bit 1:1) 


Restore Bit. (If on, : RESTORE in progress.) 






(Bit 2:1) 


Load Bit. (If on, program file is loaded.) 






(Bit 3:1) 


Exclusive Bit. (If on, file is opened with exclusive access.) 






(Bits 4:4) 


Device subtype 






(Bits 8:6) 


Device type. 






(Bits 14:1) 


File is open for write. 






(Bits 15:1) 


File is open for read 


29 




(Bits 0:8) 


Number of user labels written. 






(Bits 8:8) 


Number of user labels. 


30- 


31 




Maximum number of logical records. 


32- 


33 




File control block vector. 


34 






Checksum. 


35 






Coldload identity. 


36 






Foptions specifications. 


37 






Logical record size (in negative bytes). 


38 






Block size (in words). 


39 




(Bits 0:8) 


Sector offset to data. 






(Bits 8:3) 


Not used. 






(Bits 11:5) 


Number of extents minus 1. 


40 






Logical size of last extent size in sectors. 


41 






Extent size. 


42- 


43 




Number of logical records in file. 


44- 


107 




Two- word addresses of up to 32 disc extents, beginning with address 
of first extents (words 44-45). 


108 


-109 




File allocation time. 


110 






File allocation date. 


111 






Not used. 
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112-113 Start of file block number. 

114-115 Block number of last block. 

116-117 Number of open and closed records. 

124-127 Device class. 

* Dates are in the same format as the value returned from the CALENDAR intrinsic: 

Bits 6 7 15 

Year of Century Day of Year 



GENERAL EXAMPLES 

To list all of the files in your logon group that have X as the second alphabetic character in their names, 
enter: 

: LISTF ?xe 

FILES FOR JASON. MAN U, PEN 

EXAMP 

To list all of the three -character files in your logon group and account that end in the letter N, enter: 
; LISTF ??N 

FILES FOR JASON. MANU, PEN 
SYN 
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rLISTFTEMP 



Lists the descriptions of one or more temporary disc files for a job or session. 

SYNTAX 



PARAMETERS 

fileset Specifies the set of files to be listed. This positional parameter takes the 

following form: 

filename[ .groupname[ .acctname] ] 

The characters @, #, and ? may be used as "wildcard" characters in any posi- 
tion of the fileset parameter. The wildcard characters count toward the 
eight character limit for group, account, and filenames. These wildcard 
characters have the following meanings: 

€ Specifies zero or more alphanumeric characters. When 

used by itself, % denotes all members of the set. 

# Specifies one numeric character. 

? Specifies one alphanumeric character. 

These characters can be used with files as follows: 

n@ Lists all files starting with the character "n". 

€n Lists all files ending with the character "n". 

n@x Lists all files starting with the character "n" and ending 

with the character "x". 

n####### Lists all files starting with the character "n" followed 

by seven digits. 

?n@ Lists all files whose second character is "n". 

n? Represents all two-character files that start with the 

character "n". 

?n Represents all two -character files that end with the 

character "n". 
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Depending upon their placement in the fileset parameter, these characters 
may also be used to indicate groups and accounts. If you specify nothing 
for the group or account, MPE assumes the logon group and account. 
Default is % (all files in logon group). 

list level Displays information about the file. The options are level 0, 1, 2, or -1: 

Displays only the filename. Default is if not listlevel 
is specified. 

1 Displays the filename, file code, record size, format, the 
current end-of-file location, and the maximum number 
of records allowed in the file. It also shows whether the 
file is ASCII or binary; CCTL or NOCCTL; CIR, MSG, or 
STD). 

2 Displays all of the information found with the 1 option, 
plus the blocking factor, the number of disc sectors in 
use (including those in use for file labels and user 
headers), the number of extents currently allocated, and 
the maximum number of extents allowed. 

- 1 Displays the octal listing of the file label. The first line 

of this listing is the directory entry for the file being 
listed. The - 1 option is available only to users who have 
System Manager (SM) or Account Manager (AM) 
capability. 

listfile The name of the output file to which the descriptions are written. It is au- 

tomatically specified as an ASCII file with variable length records and these 
characteristics: closed in the temporary domain, CCTL (user supplied 
carriage -control characters), OUT access mode, and EXC (exclusive access) op- 
tion. The remainder of its characteristics are those obtained with the 
:FILE command default specifications. This file is temporary and cannot 
be overwritten by a : BUI LD command. The default is $STDLIST. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable (aborts 
execution). 



OPERATION 

This command lists descriptions of one or more temporary disc files at the level of detail you select. A file 
description will not be listed unless the file's home volume set (PV) is mounted. A standard user may 
specify level 0, 1, and 2 information for any file in the system. A user with Account Manager or System 
Manager capability may list level -1 data for files in his or her own account. When you send 
: LISTFTEMP data to the line printer or magnetic tape, the date and time will be appear at the beginning 
of the listing. 
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: LISTFTEMP displays the system file $OLDPASS only if wildcard characters are used in the file specifica- 
tion and if $OLDPASS fits the specification. 

You may have the file information displayed on a device other than your standard list device. To do so, 
name the desired device in the :FILE command, then backreference the formal filename on the 
: LISTFTEMP command line. In the following example, the filename PRTR is equated with the device class 
LP. Then, a level 2 description of all files in all groups of the logon account is sent to PRTR. 

: FILE PRTR;DEV=LP 

; LISTFTEMP e.6,2;«PRTR 

If MPE fails to locate the file you request, one of the following error messages will be displayed: 

TEMPORARY FILE NOT FOUND (CIWARN 3289) 

NO TEMP FILES EXIST (CIWARN 3284) 

If you use a wildcard character in your request, and if MPE cannot locate any files satisfying those condi- 
tions, the following warning is displayed: 

TEMPORARY FILE NOT FOUND (CIWARN 3289) 

: LISTFTEMP requires 8K of stack space to execute. If you use the command programmatically, 
make the appropriate maxdata allowances for your application. 

EXAMPLES 

The following examples illustrate several uses of the : LISTFTEMP command. 

Level (Default) Output Format 

; LISTFTEMP 6.6.6 

TEMPORARY FILES FOR JASON. MAN U, PEN 

$OLDPASS.PEN.MANU 

A J. PEN. MAN U 

A J J. PEN. MAN U 

Z10Z414A.J0N.MANU 

TEMPFILE.TEMPGROUP.SYS. 
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Level 1 Output Format 

: LISTFTEMP Bg,1 

TEMPORARY FILES FOR JASON. MANU, PEN 
ACCOUNT= MANU GROUP= PEN 



rn-cnnnc uwuc 


SIZE 


TYP 


EOF 


LIMIT 




B0N0P1 


80B 


FA 


10 


10 




BOTE TDPQ 


104B 


FA 


636 


2269 


(TEMP) 


BOXES DRAW 


128W 


FB 


84 


84 


(TEMP) 


BRAMPLES* 


80B 


FA 


20 


20 


(TEMP) 


BRRORLOG 


80B 


FAO 


12 


1024 


(TEMP) 



Level 2 Output Format 

; LISTFTEMP A@,2 

TEMPORARY FILES FOR JASON. MANU, PEN 
ACCOUNT= MANU GR0UP= PEN 

FILENAME CODE --LOGIC/ 



APPB 
APPM 
APPC 
APPK 



SIZE TYP 

88 B FA 

80 B VAM 

80 B FAO 

80B FA 



KSAM 
The column headings have the following meanings: 



KLUUK 

EOF 


j 

LIMIT R/B 


bKAUt 

SECTORS #X MX 


414 


414 16 


162 14 14 (TEMP) 


119 


240 16 


12 8 8 (TEMP) 


127 


208 16 


70 8 8 (TEMP) 


16 


200 16 


20 2 7 (TEMP) 



HEADING 

FILENAME 

CODE 
SIZE 
TYP 



MEANING 

Displays the filename. An asterisk (*) following the filename in the level 1 
and 2 option indicates the file is open for READ or WRITE access. 

Indicates a special file format. Refer to the : BUILD or :FILE command 
for a list of file codes and their meaning. 

Displays the size of the records under the heading SIZE, indicating the 
number of words (W) or bytes (B). 

The first column under this heading contains information concerning 
record format. This will be listed in one of the following ways: F (fixed 
length), V (variable length), or U (undefined length). 

The second column indicates whether the file is A (ASCII) or B (binary). 

The third column indicates the kind of file. This information will appear 
in one of the following ways: Blank (Standard file unless KSAM appears in 
the code field. ), 0, (circular file), D (message file), or R (relative I/O file). 
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In the fourth column a "C" appears only if the ;CCTL option is taken. 
EOF End of file location. 

LIMIT Maximum number of records allowed. 

R/B Blocking factor. 

SECTORS Sectors in use. 

#X Extents allocated. 

MX Maximum number of extents allowed. 

(TEMP) Temporary files. 

Level -1 Output Format 

: LISTFTEMP UDCS, -1 

F = UDCS (TEMPORARY FILES) 

052504 041523 020040 020040 001001 120353 UDCS 

052504 041523 020040 020040 041517 046504 020040 020040 UDCS COMD. 

045440 020040 020040 020040 046501 051111 051523 040440 K TECH. 

020040 020040 020040 020040 020202 004040 000001 123525 U 

123525 123525 000000 000000 000014 000000 000000 002163 .U.U 8 

000000 000000 120173 021427 000005 177650 002374 005015 

000024 000036 000000 002163 001001 120353 000400 104644 s 

001401 032743 001001 162503 001401 036363 001401 041324 ..5... .C B. 

001001 164214 001401 042166 001002 001740 001401 044134 Dv H. 

001002 002656 001401 045323 001002 006740 000400 150014 J 

oooooo 000000 000000 000000 000000 000000 000000 000000 

000000 oooooo oooooo oooooo oooooo oooooo oooooo oooooo 

oooooo oooooo oooooo oooooo oooooo oooooo oooooo oooooo 

oooooo oooooo oooooo oooooo oooooo oooooo oooooo oooooo 

OOOOOO OOOOOO 000000 OOOOOO 004072 034411 123525 000000 9..U.. 

OOOOOO 000000 000000 000000 OOOOOO OOOOOO 004073 002010 

OOOOOO OOOOOO OOOOOO OOOOOO 042111 051503 020001 000001 DISC 



• « 
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A pictorial explanation of the level - 1 output, follows: 
: LISTFTEMP filename, -1 

F = filename 



File Name (4 words-octal) Sector address of label 

■!■■ 



I I 





Disc Volume 
Number 

(Bits 0:8) 
I 



Beginning of octal File Label (Word 0) 



00 



08 



01 02 




09 10 



03 



11 



04 



05 



06 



07 ASCII 



12 



13 



14~1 RBI ASCII 



The disc file label contains the following: 
WORDS CONTENTS 



0-3 




Local filename. 


4-7 




Group name. 


8-11 




Account name. 


12-15 




Identity of file creator. 


16-19 




File lockword. 


20-21 




File security matrix. 


22 


(Bits 0:7) 


Reserved for NLS. 




(Bits 8:13) 


Not used. 




(Bits 14:1) 


Store/Restore release bit. 




(Bits 15:1) 


File secure bit: 

If 1, file secured. 
If 0, file released. 


23 




File creation date. * 


24 




Last access date. * 


25 




Last modification date. * 


26 




File code. 


27 




Private Volume Information. 




(Bits 0:1) 


Class flag bit. 




(Bits 1:3) 


Not used. 




(Bits 4:4) 


Mounted volume table index. 




(Bits 8:8) 


Volume mask. 


28 


(Bit 0:1) 


Store BIT. (If on, : STORE or : RESTORE, in progress.) 




(Bit 1:1) 


Restore Bit. (If on, : RESTORE in progress.) 




(Bit 2:1) 


Load Bit. (If on, program file is loaded. ) 




(Bit 3:1) 


Exclusive Bit. (If on, file is opened with exclusive access. ) 




(Bits 4:4) 


Device subtype 




(Bits 8:6) 


Device type. 
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(Bits 8:6) 


Device type. 




(Bits 14:1) 


File is open for write. 




(Bits 15:1) 


File is open for read 


29 


(Bits 0:8) 


Number of user labels written. 




(Bits 8:8) 


Number of user labels. 


30-31 




Maximum number of logical records. 


32-33 




File control block vector. 


34 




Checksum. 


35 




Coldload identity. 


36 




Foptions specifications. 


37 




Logical record size (in negative bytes). 


38 




Block size (in words). 


39 


(Bits 0:8) 


Sector offset to data. 




(Bits 8:3) 


Not used. 




(Bits 11:5) 


Number of extents minus 1. 


40 




Logical size of last extent size in sectors. 


41 




Extent size. 


42-43 




Number of logical records in file. 


44-107 




Two-word addresses of up to 32 disc extents, beginning with address 
of first extents (words 44-45). 


108-109 




File allocation time. 


110 




File allocation date. 


111 




Not used. 


112-113 




Start of file block number. 


114-115 




Block number of last block. 


116-117 




Number of open and closed records. 


118-119 




The time of the last file modification. 


124-127 




Device class. 



* Dates are in the same format as the value returned from the CALENDAR intrinsic: 
Bits 6 7 15 

Year of Century Day of Year 

GENERAL EXAMPLES 

To list all of the files in your logon group that have X as the second alphabetic character in their names, 
enter: 

; LISTFTEMP ?Xg 

TEMPORARY FILES FOR JASON. MAN U, PEN 

EXAMP 
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To list all of the three-character files in your logon group and account that end in the letter N, enter 
: LISTFTEMP ??N 

TEMPORARY FILES FOR JASON. MANU, PEN 
SYN 



2-202 



:LISTGROUP 



Prints a list of attributes for groups. 

SYNTAX 



{group. acct) 
{group } 

LISTGROUP {e.acct ) [^listfile] 

<g } 

<e.e } 



PARAMETERS 



group, 
acct 

group 

Q.acct 



Specifies that all groups in the logon account are to be listed. Default. 

Specifies that all groups in all accounts are to be listed. Only users with SM 
capability may specify this option. Default is %. 

Specifies the group and account to be listed. Account Managers cannot 
specify an account other than their own. 

Specifies the group (in the logon account) to be listed. Default is %. 

Specifies that all groups in the designated account are to be listed. If an 
Account Manager specifies an account, it must be his or her own account. 
Default is g. 



Note that the characters §, #, and ? can be used as "wildcard" characters, but will count toward the eight 
character limit. These wild card characters have the following meanings: 



€ 



Specifies one or more alphanumeric characters or denotes all members of 
the set. 



# Specifies one numeric character. 

? Specifies one alphanumeric character. 

The characters can be used as follows: 

n@ List all groups starting with the character "n". 

List all groups ending with the character "n". 



6n 
ngx 

n##. 

?n@ 



List all groups starting with the character "n" and ending with the charac- 
ter "x". 

List all groups starting with the character "n" followed by up to seven 
digits. 

List all groups whose second character is "n". 
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n? List all two-character groups starting with the character "n". 

?n List all two-character groups ending with the character "n". 

list file Destination of the attribute listing. The default is $STDLIST, but the out- 

put may be redirected with the : FILE command. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts execu- 
tion). A user must have Account Manager (AM) or System Manager (SM) capability to execute this 
command. 



OPERATION 

This command lists the attributes for all groups in one account (AM capability) or all groups in all ac- 
counts (SM capability). Also available is information on groups spanned to Private Volumes (PV), whether 
or not the volumes are mounted when the information is requested. 

A sample octal dump appears below. The listing includes both group and system information, headed by "G 
= " and the group's name. A translation of those bytes that contain alphanumeric ASCII characters ap- 
pears to the right of each line of the octal dump. 

G = PUB 

050125 041040 020040 020040 000514 020040 020040 020040 PUB L 

020040 000000 001026 077777 177777 000000 046536 077777 M... 

177777 000002 006457 077777 177777 020410 041010 000601 B... 

000000 000516 020040 020040 020040 020040 020040 020040 ...N 

020040 020040 020040 020040 020040 020040 000000 000000 

000000 

Below is the octal listing translated into its decimal representation: 

__00-- --01-- --02 03-- --04-- --05-- --06-- --07-- 

—08 09 10 11 12 13 14 15— 

--16-- --17-* 18 19 20 21 22-- —23— 

__ 24 25 26 27 28 29 30 31 — 

--32 33 34 35 36 37 38 39— 

—40— 
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The information in the octal dump is decoded in the following table: 



WORDS 


CONTENT 


0-3 


Group name, in ASCII. 


4 


File index pointer. 


5-8 


Password. 


9-10 


Permanent file space usage count (in sectors). 


11-12 


Permanent file space limit (in sectors). 


13-14 


Central -processor time usage count (in seconds). 


15-16 


Central -processor time limit (in seconds). 


17-18 


Connect-time count (in minutes). 


19-20 


Connect-time limit (in minutes). 


21-22 


Purge and group -security flags. 


23 


Capability -class attributes. 


24 


Group directory base linkage. 


25 


Group volume set definition index. 


26-29 


Definition's account name. 


30-33 


Definition's group name. 


34-37 


Definition's volume set name. 


38 


GSAVEFIPNTR 


39 


GMOUNTRECNTR 


40 


GSPARE 



Where: 

• GSAVEFIPNTR contains the original Group File Index Pointer or an address relative to the base of the 
SYSVS (System Volume Set) directory. 

• GMOUNTRECNTR is a counter which keeps track of the number of times a group's Home Volume Set has 
been bound. 

• GSPARE is an MPE reserved word. 

• The group name and password are eight -character names, right -padded with blanks. 

• The double word numeric quantities are double word integers, with % 17777777777 representing 
"unlimited". 

• Group attributes duplicate the second word of the double word capability returned by the -WHO in- 

trinsic. Refer to the MPE V Intrinsics Reference Manual (32033-90007). 

EXAMPLE 

To list the attributes of the PUB group in his or her own account, the Account Manager enters: 

; LISTGROUP PUB 

G ■ PUB 

050125 041040 020040 020040 000514 020040 020040 020040 PUB L 

020040 000000 001026 077777 177777 000000 046536 077777 M... 

177777 000002 006457 077777 177777 020410 041010 000601 B... 

000000 000516 020040 020040 020040 020040 020040 020040 ...N 

020040 020040 020040 020040 020040 020040 000000 000000 

000000 
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:LISTLOG 



Lists currently active logging identifiers on the system and whether log file changing has been enabled. 



SYNTAX 




PARAMETERS 

logid 



PASS 



The specific logging identifier to be verified. Default is to list all currently 
active logging identifiers on the system. 

Causes the password associated with the logging identifier to be displayed. 
The password can be used only by the creator of the logging identifier. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have User Logging (LG) capability to execute this command. 

OPERATION 

This command lists the logging identifier specified with its associated creator and log file. The column 
labeled : CHANGE indicates whether the :CHANGELOG command is permitted: that is, whether the name of 
the first logging file ends in "001" and thus follows the naming convention required by the :CHANGELOG 

I command. The column labeled AUTO indicates whether an automatic CHANGE LOG is permitted: that is 
whether the AUTO parameter has been specified with a :GETLOG or : ALTLOG command. 

If the logid parameter is not entered, all logging identifiers on the system are displayed with their creators 
and log files. The PASS parameter, which can be used only by the creator of the logging identifier 

I specified, causes the password associated with the logging identifier to be listed. You must have System 
Supervisor (OP) or User Logging (LG) capability in order to use this command. 

EXAMPLE 

To list all logging identifiers on the system, enter: 
:LISTLOG 



LOGID 


CREATOR 


CHANGE 


AUTO 


CURRENT LOGFILE 


TESTLOG 


LALITHA.MPEM 


YES 


YES 


LAL001.PEJAVAR.MPEM 


TEST1 


MARK.MPEM 


YES 


NO 


M001.KSAM3000.MPEM 


TEST2 


PAT.MPEM 


NO 


NO 


TEST. ALVAREZ. MPEM 



AUG 1986 
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ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 

MPE V Intrinsics Manual (32033-90007). 

Refer also to the :ALTL0G, :CHANGELOG, and : GETLOG commands in this section. 
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:LISTUSER 



Lists attributes currently assigned to users. 

SYNTAX 



{user.acct} 
{user 
iLISTUSER {Q.acct 
{i 



[tlistfile] 



PARAMETERS 

user.acct 

user 
%.acct 



The specified user in the specified account. If Account Managers specify 
acct, it must be their own account. 

The specified user in the logon account. 

All users in the specified account. Account Managers may specify their 
own account only. 

All users in the logon account. Default. 

All users in all accounts. (The attributes of the account are also listed.) 
This option can be specified only by users with System Manager (SM) 
capability. 

Note that the characters %, #, and ? can be used as "wildcard" characters, 
but will count toward the the eight character limit. These wild card 
characters have the following meanings: 



@ 



Specifies zero or more alphanumeric characters and 
denotes all members of the set. 



# Specifies one numeric character. 

? Specifies one alphanumeric character. 

The characters can be used as follows: 



gn 
ngx 

n##. 

?n@ 



List all users starting with the character "n". 

List all users ending with the character "n". 

List all users starting with the character "n" and ending 
with the character "x". 

List all users starting with the character "n" followed by 
up to seven digits. 

List all users whose second character is "n". 
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List all two -character users starting with the character 



List all two-character users ending with the character 



list file 



Destination of the attribute listing. The default is $STDLIST, but the out- 
put may be redirected with the : FILE command. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts execu- 
tion). A user must have AM (Account Manager) or SM (System Manager) capability to execute this 
command. 

OPERATION 

This command generates an octal dump of the attributes currently assigned to users. Each entry is headed 
by a "U = " and the user's name; it contains both user and system information. A translation of those 
bytes containing ASCII data appears to the right of each line, as shown in the sample below. Account 
Managers may list only users in their own account, while System Managers may specify all users in all ac- 
counts on the system. 

U = COMGRAMS 

041517 046507 051101 046523 060003 000613 000000 000000 COMGRAMS 

020040 020040 020040 020040 050125 041040 020040 020040 PUB 

000000 040226 000121 Q 



The octal information is translated into a decimal representation below. 



-00- 
-08- 
-16- 



-01 02-- 

-09 10-- 

-17 18— 



-03- 
-11- 



-04- 
-12- 



-05- 
-13- 



•06- 
•14- 



-07- 
■15- 



Each word or group of words is decoded in the following table: 



WORDS 



0-3 

4-5 

6-7 

8-11 

12-15 

16 

17 

18 



CONTENT 



User name. 

Capability 

Local attributes. 

Password. 

Home group. 

Number of users logged -on. 

Maximum job priority 

User entry in COMMAND. PUB. SYS 
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• The username, password, and home group are eight -character names, right padded with blanks. 

• Capability can be decoded by reference to the WHO intrinsic. Refer to the MPE V Intrinsics Reference 
Manual (32033-90007). 

• The maximum job priority is a numerical quantity; 1 50 (%226 ) for example, represents the CS 
subqueue. 

EXAMPLE 

To list the attributes of the user MGR in the account SOPRH, enter: 

: LISTUSER MGR.SOPRH 
U = MGR 

046507 051040 020040 020040 077607 000713 000000 000000 MGR 

020040 020040 020040 020040 050125 041040 020040 020040 PUB 

000002 040226 000466 6 
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LISTVS 



Produces a formatted listing of volume set definition information. 



SYNTAX 




PARAMETERS 

Dslist 



Specifies the volume set definitions to be listed. This positional parameter 
has the form: 

osname [ . groupname [ . acctname] ] 

The characters g, #, and ? can be used as wildcard characters in any posi- 
tion of the vslist parameter. The wildcard characters count toward the 
eight character limit for user, group, account, and filenames. These 
wildcard characters have the following meanings: 



6 
# 



Specifies one or more alphanumeric characters. When 
used by itself, @ denotes "all members of the set". 



Specifies one numeric character. 
? Specifies one alphanumeric character. 

These characters can be used as follows: 

Lists all volume set definitions starting with the charac- 



ng 

6n 

ngx 

n####### 

n? 



ter n . 



Lists all volume set definitions ending with the character 



Lists all volume set definitions starting with the charac- 
ter "n" and ending with the character "x". 

Lists all volume set definitions starting with the charac- 
ter "n" followed by seven digits. 

Lists all volume set definitions whose second character is 

M II 

n . 

Lists all two -character volume set definitions starting 
with the character "n". 

Lists all two -character volume set definitions ending 
with the character "n". 
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Note that depending upon the placement of these characters in the vslist 
parameter, they can also be used to replace group and account names. If 
you do not specify names for the group or account, MPE assumes the logon 
group and account. Default is @ (lists all home volume sets in logon group). 

0, 1, or 2 Displays information about volume sets. The option displays volume set 

names and volume class names The 1 displays the information shown for 
as well as volume names of volume set members and volume class members, 
and types of devices on which the volumes reside. The 2 option displays the 
information shown for and 1. With the 2 option, if the device is mount- 
ed, then the Idev and the status "MOUNT 1 also appear. An asterisk (*) follow- 
ing a volume set indicates that the volume set is mounted . Default is 0. 

list file Actual file designator of output file to receive listings. Default is 

$STDLIST. If you do not use the default, this file must be named in a 
:FILE command and backreferenced. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts execu- 
tion). A user must have Use Volumes (UV) or Create Volumes (CV) capability to execute this command. 

OPERATION 

The : LISTVS command allows you to determine the configuration of a volume set and produce a format- 
ted listing of volume set definition information. 

The numeric parameter of the : LISTVS command determines the amount of information displayed. If 
omitted or if a is specified, item 1 in the following list is displayed. If detail is 1 , items 1 through 3 are 
displayed. If detail 2 is specified, items 1 through 4 are displayed: 

1. Volume set names and volume class names. 

2. Volume set member volume names and types. 

3. Volume class member volume names and types. 

4. Logical device numbers (Idev) and status of the devices on which the volume set is mounted. This in- 
formation is omitted for any volume set not currently mounted. 
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EXAMPLES 

To display the all members, numbers, class names, and types of the volume set, along with the logical 
device number and status of the volume set, enter: 

.- LISTVS.2 
ACCOUNT= TECH PUBS GROUP= MAC 

VOLSET MEMBERS TYPE LDEV STATUS 

MAC* MAC HP7920 4 MOUNTED 

To display the members and type of the volume set for all users and accounts, enter: 

; listvs e.e,i 

ACCOUNT= TECH PUBS GROUP* MAC 
VOLSET MEMBERS TYPE 

MAC* MAC HP7920 

To display the volume set numbers and volume class names, enter: 

; LISTVS e.6,0 
ACCOUNT* TECH PUBS GROUP= MAC 

VOLSET 



MAC* 

To display volume set definition information for volume sets in your logon group and account, with the 
listing sent to a line printer, enter: 

: FILE LIST;DEV=LP 
: LISTVS @»1;»LIST 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (3203 3-90005) 
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:LMOUNT 



Performs a logical mount of a private volume set. 

SYNTAX 



; LMOUNT ocsname. group. account [|jGEN= [genindex] ] 



PARAMETERS 

Vcsname Volume class/set name which specifies the mounting of a previously 

defined volume class or volume set. 

group. account Specifies the group and account under which the volume set was created. 

genindex A value from - 1 to 32767 specifying which generation of the volume set is 

to be mounted ( - 1 allows any generation to be mounted). If omitted, the 
system does not check the generation version of the specified volume set. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is ex- 
ecutable only at the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

When the : LMOUNT command executes, all disc drives containing members of the specified volume set be- 
come ASSIGNED. Each volume set is logically attached to the drive until a : LDISMOUNT command is ex- 
ecuted, at which time the disc drive becomes AVAILABLE. 

System users issue mount requests implicitly through their programs, or explicitly with a : MOUNT com- 
mand. User initiated mount requests cause the specified volume set to be linked into the system's account- 
ing structure at the group level. This is called "binding". When the Console : LMOUNT command is ex- 
ecuted, no such binding occurs. 

If the Private Volumes Facility was enabled with :VMOUNT ON, AUTO, MPE will automatically attempt to 
satisfy the mount request; the : LMOUNT will succeed if the specified volume class/set is physically connec- 
ted to the system. 

If the Private Volumes Facility was enabled with : VMOUNT ON (omitting the AUTO parameter), you must 
reply to your own mount request, even though the volume class/set may already be mounted and in use. 
If the specified volume class/set is not physically present, the system looks for available drives of the types 
required to satisfy the request. If sufficient drives are available, the system reserves them and prints a 
message telling you to mount the volume class/set on one or more logical devices, and to reply "YES " or 
"NO ". If sufficient drives are not available, the system reserves those which will satisfy part of your 
request, and prints a message listing the type and number of drives it requires. 
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If you can free the required drive(s), reply "YES" after the drive is AVAILABLE. If you reply "NO", the 
original : LMOUNT request will be canceled. 

EXAMPLE 

To mount a private volume set named DATABASE, in the PAYROLL group of the ACCTNG account, enter: 
: LMOUNT DATABASE . PAYROLL . ACCTNG 

ADDITIONAL DISCUSSION 

Refer to the discussion of "PRIVATE VOLUMES" in the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). 
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:LOG 



Starts, restarts, or stops User Logging. 

SYNTAX 



:LOG 


logid { 


^RESTART} 
.START } 
.STOP } 



PARAMETERS 

logid Logging identifier previously established with a user rGETLOG command. 

START Initiates a logging process. 

RESTART Restarts a logging process. 

STOP Terminates a logging process. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is ex- 
ecutable only at the Console unless distributed to users with the : ALLOW command. 

OPERATION 

This command allows you to start, restart, or stop User Logging. For further discussion of User Logging 
refer to the MPE V System Operation and Resource Management Manual (32033-90005) and to the MPE 
V Intrinsics Reference Manual (32033-90007). 

The release of the G. 02. 00 version of MPE makes it unnecessary to use the : LOG command (with STOP 
START, or RESTART) to change log files. You may change log files "on the fly", without the delay normal- 
ly caused by executing a :LOG command. You can use the : CHANGE LOG command to enable interactive 
log file changing, or you may use the AUTO parameter of the : ALTLOG and :GETLOG commands to enable 
automatic log file changing. Refer to the commands : ALTLOG, : CHANGE LOG, :GETLOG, and 
:SHOWLOGSTATUS in this section of the manual. 

EXAMPLE 

To start the logging process identified by logid LOGPROCX enter: 
:LOG LOGPROCX, START 
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=LOGOFF 



Aborts all executing jobs/sessions and prevents any further logon. 

SYNTAX 



= LOGOFF 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console. 

OPERATION 

This command sets the job and session execution limits to and aborts all jobs and sessions, including the 
session logged onto the System Console. To enter subsequent console commands, you must logon to the 
console using = LOGON. 

Execution of this command leaves the system in a job/session inactive state. However, since devices are 
still job/session accepting, job introduction is not disabled: System Managers and System Supervisors can 
still introduce and run HI PR I jobs. Spoolers will remain operating, but unless a user is able to initiate a 
HI PR I session at the System Console, it is impossible to alter their operation. 

Any pending requests that require a =REPLY from the System Console must be satisfied before issuing 
= LOGOFF, or MPE will abort the requests. 

EXAMPLE 

To abort all executing jobs/sessions, enter: 

A C 

= LOGOFF 

16.53/25/ALL JOBS LOGGED-OFF 
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=LOGON 



Enables job/session processing following = LOGOFF 

SYNTAX 



=LOGON 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console. 

OPERATION 

This command enables the processing of jobs/sessions following the execution of the - LOGOFF command. 
=LOGON re-establishes the job/session limits that were in effect before the execution of a =LOGOFF 
command, and allows non-HIPRI jobs/sessions to logon again. 

EXAMPLE 

To enable job/session processing, enter: 
= LOGON 
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MOUNT 



Requests the System Operator to mount a volume set. 



SYNTAX 



: MOUNT 



{ 



>, 



{ Ocsname )Ugroupnan*[&xootnam]] 
[|GEN= [genindex] ] 



PARAMETERS 



* or ocsname 



groupname . ace t name 



genindex 



Specifies the volume set or volume class name. The asterisk (*) specifies the 
home volume set for the group and account specified, or the logon group 
and account if groupname. acctname is not specif ied. The vesname param- 
eter is the volume class/set name, specifying a previously defined (with a 
: NEWVSET command) volume class name or volume set name. Default is (•). 

Specifies the group and account under which the volume set was created. 
Default is logon group and account. 

A value from - 1 to 32767 specifying which generation of the home volume 
set is to be mounted. A value of - 1 indicates that any generation is permit- 
ted. If omitted, the system will ignore the generation when attempting to 
satisfy the : MOUNT request. 



USE 

This command may be issued from a Session, Job or in BREAK. It may not be used from a Program. It is 
not Breakable. 

OPERATION 

The : MOUNT command connects you to a specific volume set. In addition, this command allows you to 
specify that the volume set is to be treated as a home volume set; therefore, it is to be bound to the sys- 
tem's accounting structure with respect to a particular group. The : MOUNT command is rejected if there 
is an operator initiated : LDISMOUNT command pending for the specified volume set. The requesting job is 
suspended until the mount is completed or rejected. 
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In addition, various user commands which give you access to your logon group's home volume set will 
implicitly initiate mount requests if the volume set is not mounted already. An example of one of these 
commands ( : BUI LD) is: 

: BUILD VFILE;DISC=500,10,1;REC=-80;DEV=VCLASS1 

To issue a mount request programmatically you may issue an FOPEN call referencing a file residing on an 
unmounted volume set; this causes an implicit user initiated mount request. An FOPEN mount remains in 
effect until a corresponding FCLOSE intrinsic call is issued. The programmatic request is used when a 
single job/session step requires a certain volume set. Refer to the MPE V Intrinsics Reference Manual 
(32033-90007) for a description of programmatic mounting. 

EXAMPLE 

To request the System Operator to mount volume set MYSET, generation index 43, enter: 
•. MOUNT MYSET;GEN=43 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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:NEWACCT 



Creates a new account and an associated Account Manager and PUB Group. 

SYNTAX 



rNEWACCT acct name, mgrname 
[ I PASS=[ password]] 
[%FILES=[filespace]] 
[;CPU=[cpu]] 
[|CONNECT= [connect]] 
[iCkP=[capabilitylist]] 
[;;ACCESS= [fileaccess] ] 
tlMkXPRI = [subqueuename] ] 
[iLOCKTTR=[localattribute]] 
[|VS=[i>olset:SPAN]] 
[fUSERPASS=[<j^j] (1) 



PARAMETERS 

ace t name 
mgrname 



Name to be assigned to the new account. This name must contain from one 
to eight alphanumeric characters, beginning with an alphabetic character. 

Name of the Account Manager. This is always the first user created under 
the account. The manager receives the following attributes: 



• User Password 

• Capability List 

• Scheduling Priority 

• Local Attribute 

• Home Group 



None. 

Same as the account capability list. 

Same as the account maximum priority. 

Same as account local attributes. 

PUB 



The attributes of an Account Manager may be changed with the : ALTUSER 
command after mgrname is defined. However, in no case, is this user 
granted attributes greater than those assigned the account. 

( 1 ) The USERPASS parameter is available only if HP Security Monitor (HP30392) has been installed. 
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passu)ord 



filespace 



cpu 



connect 



capabilitylist 



Account password, used for verifying logon access only. This password must 
contain from one to eight alphanumeric characters beginning with an 
alphabetic character. Default is that no password is assigned. 

Disc storage limit, in sectors, for the permanent files of the account. The 
maximum value you may define is 2,147,483,647 sectors. Default is 
unlimited file space. 

Limit on total CPU time, in seconds, for this account. This limit is checked 
only when a job or session is initiated, thus, the limit never causes the job or 
session to abort. The maximum value you may define with rNEWACCT is 
2,147, 483 , 647 seconds. Default is that no limit is assigned. 

Limit on total session connect time, in minutes, allowed the account. This 
limit is checked at logon, and when the job or session initiates a new 
process. The maximum value you may define is 2, 147,483,647 minutes. 
Default is that no limit is assigned. 



List of capabilities, separated by commas, permitted this account, 
capability is denoted by a two-letter mnemonic, as follows. 

System Manager * SM 

Account Manager = AM 

Account Librarian = AL 

Group Librarian = GL 

Diagnostician = DI 

System Supervisor = OP 

Network Administrator ■ NA 

Node Manager = NM 

Permanent Files = SF 
Access to non-sharable 

I/O devices = ND 

Use Volumes ■ UV 

Create Volumes ■ CV 
Use Communications 

Subsystem = CS 

Programmatic Sessions «= PS 

User Logging = LG 

Process Handling ■ PH 

Extra Data Segments - DS 

Multiple RINS « MR 

Privileged Mode » PM 

Interactive Access = I A 

Local Batch Access * BA 



Each 



Default is AM,AL,GL,SF,ND,IA,BA. 
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fileaccess 



File access restrictions assigned the account. Default is R , L , A , W , X : AC . 

([{A}[,...]:j^ Y J ][;...]) 
{W} * Al - ' 

{X} 

where R, L,A, W, and/or X specify modes of access by types of users (ANY 
or AC ) as follows: 

R = Read 

L ■ Lock (allows exclusive access to file) 

A = Append (implicitly specifies L also) 

W ■ Write (implicitly specifies A and L also) 

X ■ Execute 

The user types are specified as follows. 



subqueuename 



ANY = Any user 

AC = Member of this account only 

The default is no security restrictions at the account level. Two or more 
modes may be specified if they are separated by commas. Both user types 
may be specified if they are separated by commas. 

The name of the subqueue of highest priority that can be requested by any 
process of any job/session in the account. This parameter is specified as 
AS , BS , CS , DS , or ES . 



CAUTION 



Processes capable of executing in the AS or BS subqueues can 
deadlock the system. Assigning non -priority system and user 
processes to these subqueues can prevent critical processes 
from executing. Exercise extreme caution when assigning 
processes to these subqueues. 



localattribute 



oolset 



The local attribute of the account, as defined at the installation site. This 
is a double-word bit map used to further classify accounts. When it is not 
part of standard MPE security provisions, programmers may define local 
attributes (which will be checked by the -WHO intrinsic) to enhance their 
software's security. Default is double -word . 

The volume set or class reference which, when fully qualified, is in the 
form vcsid.groupname.acctname, where vcsid refers to a previously defined 
volume set or class. 
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SPAN Specifies that the account name is to be inserted in the accounting directory 

of the specified volume set (volset). The specified volume set must have 
been physically mounted previously for the SPAN operation to succeed. 

The associated Account Manager and PUB group are not created in the 
accounting directory of the specified volume set. 

Once the account has been spanned to the volume set, it does not need to be 
spanned again (for example, the volset parameter is not necessary) on 
another system which shares the volume set under the same account name. 

REQ USERPASS=REQ specifies that all users in the account are to have 

non -blank passwords. If you require user passwords, MPE assigns the 
Account Manager a blank, expired password. The Account Manager must 
select a new password the first time the Manager logs on. It is available 
only if HP Security Monitor has been installed. 

OPT USERPASS=OPT specifies that users of the account may or may not have 

passwords. Default. It is available only if HP Security Monitor has been 
installed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have System Manager (SM) capability to execute this command. 

OPERATION 

The :NEWACCT command may only be executed by the System Manager. The System Manager is 
responsible for establishing the accounting structure best suited to the computer installation. 

When a keyword is specified, but its corresponding parameter is omitted (as in ;ACCESS= ), the default 
value for that keyword is assigned (in this case, R, L, A, W, X:AC). The default is also assigned when 
an entire keyword parameter group (such as ; kCCESS=fileaccess) is omitted. 

After the System Manager creates accounts and their PUB groups, and has designated the Account 
Managers for those accounts, the new Account Managers may logon and redefine their own attributes and 
those of their PUB groups. Account, Managers also define new users and groups. However, the capabilities 
and attributes the Account Managers assign to groups and users cannot exceed those assigned to the 
account itself by the System Manager. For example, if the System Manager does not assign the account DS 
capability, no users in the account are permitted DS capability (so they will not be able to use extra data 
segments). 

The PUB Group is initially assigned no password and the same capability class attributes, permanent file 
space limit, CPU limit, and connect time limit as the account. Its initial security allows READ and 
EXECUTE access to all users who successfully logon to the account, and APPEND, WRITE, LOCK, and 
SAVE access to Account Librarian (AL) and Group Users (GU) only. These access provisions are 
(R,X:ANY;A,W,L,S:AL,GU). 
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EXAMPLE 

To create an account with the account name AC I , and the Account Manager name MNGR , with all other 
parameters assigned by default, enter: 

: NEWACCT ACI,MNOR 

ADDITIONAL DISCUSSION 

HP Security Monitor Users Guide (30392-90001) 
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:NEWGROUP 



Creates a new group within an account. 

SYNTAX 



: NEWGROUP groupname [ .account name] 
[|PASS= [passtiord] ] 
[|FILES=[/iiespace]] 
[|CPU=[cp«]] 
[|CONNECT= [connect ] ] 
\]§CPiP=[capabilitylist] ] 
[|ACCESS= [fileaccess] ] 
[lVS=[i>oZsei[:SPAN]]] 



PARAMETERS 

groupname 

account name 

password 

capabilitylist 



The name of the new group, which must consist of one to eight al- 
phanumeric characters, beginning with an alphabetic character. 

As System Manager you can include the account name when logged onto an 
account other than the requested account. 

Group password, used for verifying logon access only. Default is that no 
password is assigned. 

A list of capability -class attributes, consisting of any or all of the following: 
I A, BA, PM, MR, DS, or PH, where: 



Process Handling 


= PH 


Extra Data Segments 


= DS 


Multiple RINS 


= MR 


Privileged Mode 


= PM 


Interactive Access 


= IA 


Local Batch Access 


= BA 



filespace 



This list imposes a limit on program files belonging to the group. A 
capability cannot be assigned to the group if it has not been defined for the 
account in which the group resides. Default is IA , BA . 

Disc storage limit, in sectors, for the permanent files of the group. You 
cannot specify a filespace for a group that is greater than the limits cur- 
rently defined for the group's account. If an account's filespace is changed 
later, group limits are automatically changed. Default is a storage limit 
equivalent to the account's filespace . 
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cpu 



Limit on total CPU time, in seconds, for the group. This limit is checked 
when a job or session is initiated, and, if exceeded during an active job or 
session never causes the job or session to abort. If the limit is exceeded, new 
jobs or sessions will be prevented from initiating until the counter is reset 
with the :RESETACCT command. The maximum value you may define 
with this command is 2,147,483,647 seconds. However, you cannot 
specify a group's CPU limit that exceeds the limit defined for the account. 
If an account's CPU limit is changed later, the groups' limits will be chang- 
ed automatically. Default is the account CPU limit. 



connect 



Limit on total session connect time, in minutes, allowed the group. This 
limit is checked at logon, and when the job or session initiates a new 
process. The maximum value you may define is 2,147,483,647 minutes, 
and it cannot exceed the limit defined for the account. If the account con- 
nect is later changed, the group connect time is automatically changed. 
Default is the account connect limit. 



fileaccess 



The restriction on file access pertinent to this group. Default is 
R,X:ANY;A,W,L,S:AL,GU for the Public Group (PUB); and 
R,A,W,L,X,S:GU for all other groups. 



{R> 
{L} 
{A} [,...]: 

{w> 
{x> 

1 


{ANY} 

{AC } 

{GU } . . 

{AL } l,, " J 

{GL } 


I 
GL) as follows: 




R = Read 

L = Lock (exclusive file access) 

A = Append (implies L) 

W = Write (implies A and L) 

X = Execute 

S = Save 



The user types are specified as follows: 

ANY = Any user 

AC = Member of this account only 

GU = Member of this group only 

AL = Account librarian user only 

GL = Group librarian user only 

Two or more user or access types may be specified if they are separated by 
commas. 



vol set 



The volume set or class reference which, when fully qualified, is in the 
form vcsid.groupname.accountname, where vcsid refers to a previously 
defined volume set or class. 
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SPAN The SPAN option specifies that groupname is to be inserted in the 

accounting directory of the specified volume set (volset). The specified 
volume set must have been previously mounted physically for the SPAN 
operation to succeed. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Account Manager (AM) capability to execute this command. 

OPERATION 

Account Managers use the tNEWGROUP command to create groups within their accounts and assign 
attributes to each. The attributes assigned to the group may not exceed those permitted the accounts 
themselves (defined when the System Manager created the accounts). However, within account limits, the 
Account Manager may redefine the group and user attributes and capabilities, as well as those of the PUB 
group. 

MPE initially assigns the PUB group no password and the same capability-class attributes, permanent file 
space limit, and CPU time limit as the account. Its initial security grants READ (R) and EXECUTE (X) 
access to all users (ANY), It assigns APPEND (A), WRITE (W), LOCK (L), and SAVE (S) access to the 
Account Librarian (AL) and Group Users (GU) only. 

When you omit a keyword parameter (such as ;PASS=) or keyword parameter group (such as 
; PkSS=password) from the :NEWGROUP command, MPE assigns the default value corresponding to that 
parameter. 

EXAMPLE 

To create a new group named GROUP 1 with all default capabilities, enter: 
: NEWGROUP GR0UP1 

ADDITIONAL DISCUSSION 

MPE V Account Structure and Security (32033-90136) 
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:NEWUSER 

Defines a new user. 

SYNTAX 



:NEWUSER username[. account name] 
[;PASS= [password] ] 
[;CAP= [capabilitylist] ] 
[ ; MAX PR I = [subqueuename] ] 
[fiLOCKTTR=[localattribute] ] 
[i H OME = [homegroupname] ] 
[jUSERPASS=[{op°j] ^EXPIRED]] (1) 



PARAMETERS 



username 



account name 



password 



capabilitylist 



The name of the user. The name must consist of one to eight alphanume 
characters, beginning with an alphabetic character. 

As System Manager you can include the account name when logged onto 
account other than the requested account. 

User password, used for verifying logon access only. The password m 
consist of one to eight alphanumeric characters, beginning with 
alphabetic character. Default is that no password is assigned. 

List of capabilities, separated by commas, permitted this user. El 
capability is denoted by a two-letter mnemonic, as follows: 



System Manager 


s 


SM 


Account Manager 


= 


AM 


Account Librarian 


■ 


AL 


Group Librarian 


m 


GL 


Diagnostician 


BE 


DI 


System Supervisor 


B 


OP 


Programmatic Sessions 


as 


PS 


Network Administrator 


» 


NA 


Node Manager 


s 


NM 


Permanent Files 


s 


SF 


Access to nonsharable 


B 


ND 


I/O devices 






Use Volumes 


= 


UV 



( 1 ) The USERPASS parameter is available only if HP Security Monitor has been installed. 
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Create Volumes 
Use Communications 
Subsystems 
User Logging 
Process Handling 
Extra Data Segments 
Multiple RINs 
Privileged Mode 
Interactive Access 
Local Batch Access 



CV 
CS 

LG 
PH 
DS 
MR 
PM 
IA 
BA 



subqueuename 



Capabilities assigned to the user with the ;CAP= parameter cannot exceed 
those assigned the account. If the account's capabilities are altered, any 
capabilities removed from the account are also removed from the user. The 
user's capabilities are always verified to be a subset of the account's at 
logon. This prevents a user from being granted a capability not assigned 
the account. Note that CV capability, which allows users to define Private 
Volumes, also gives the user UV capability, so that they may use private 
volumes. Default is IA, BA, ND, SF. 

The name of the highest priority subqueue that any job or session in the 
account can request for executing processes. The subqueuename may be 
either AS, BS, CS, DS, or ES. The priority specified for the user in 
:NEWUSER cannot be greater than that specified for the account. 

The subqueuename defined for the user is checked against the 
subqueuename defined for the user's account at logon. The lower priority 
of the two is used as the maximum priority and restricts all processes of the 
job/session. Also, the priority requested by the user at logon is checked 
against the subqueuename defined for that user, and the lower of these two 
values is granted. Default is CS. 



CAUTION 



Processes capable of executing in the AS or BS subqueues can 
deadlock the system. Assigning non -priority system and 
user processes to these subqueues can prevent the execution 
of critical system processes. Exercise extreme caution in 
assigning processes to these subqueues. 



localattribute 



homegroupname 



The local attribute of the user, as defined at the installation site. This is a 
double word bit map of arbitrary meaning which might be used to further 
classify users. While it is not involved in standard MPE security provisions, 
it is available to processes through the WHO intrinsic for use in the 
programmer's own security provisions. The : NEWUSER command checks the 
local attributes of the user with those of the account. Default is double 
word (null). 

The name of an existing group to be assigned as the user's home group. If 
none is assigned, the user must always specify a group when logging on. 
Default is that no home group is assigned. 
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REQ USERPASS=REQ requires that the user have a non-blank password. It is 

available only if HP Security Monitor has been installed. 

OPT USERPASS=OPT makes a user password optional. Default. It is available 

only if HP Security Monitor has been installed. 

EXPIRED The password expires immediately. The user cannot logon without selecting 

a new password. It is available only if HP Security Monitor has been 
installed. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have AM capability to execute this command. 

OPERATION 

The Account Manager uses the :NEWUSER command to define an account member. When the user is 
defined, the Account Manager may also assign the user a password, capabilities, and limit the user's use of 
system resources. Parameters defining these values may also be omitted from the command line; in this 
case, the defaults will be assigned the user. 

EXAMPLE 

To define a new user named LHSMITH , assign a password of SMITTY , and a homegroup of HOMEGPX , 
enter: 

: NEWUSER LHSMITH ; PASS=SMITTY ; HOME=HOMEGPX 

ADDITIONAL DISCUSSION 

HP Security Monitor Users Guide (30392-90001) 
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:NEWVSET 



Defines private volume sets and classes. 

SYNTAX 



:NEWVSET ys/?a/n^|MEMBERS=i>«ame:type[;|i>wan»;type. . . ] 
\M!CLkSS=tfcname:oname[^oname. . .]] 



PARAMETERS 



vsname 



oname:type 



ocname:oname 



Volume set name, consisting of one to eight alphanumeric characters, 
beginning with an alphabetic character. This name is also given to the 
master volume of the set. MPE references vsname as vsname. groupname.ac- 
ctname, where groupname and acctname are the logon group and account. 

Names of members of the volume set and the types of devices on which the 
members will reside. A maximum of eight volume names can be specified. 
The list of volume names must include the master volume set name. The 
type of disc to accommodate the volume must be specified with each 
vsname. The type can be HP 7902A, HP 7905, HP 7906, HP 7911, HP 
7912, HP 7914, HP 7920, HP 7925, HP 7933, HP 7935, HP 7945 or HP 
9895. 

Volume class name, consisting of one to eight alphanumeric characters, 
beginning with an alphabetic character. Each volume class consists of a 
volume class name and an associated list of volume names (Uname). The list 
of volume names must be a subset of the volumes composing the volume set, 
and one of the volume names must be that of the set's master volume. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Create Volumes (CV) capability to execute this command. 

OPERATION 

The : NEWVSET command defines private volume sets and classes, making known to MPE the members of 
the volume set and their corresponding storage types. Once a volume set or volume class is defined, its 
definition is kept on disc in a volume set definition entry. A physical volume set is not created at the time 
the volume set is defined. 



2-231 



EXAMPLE 

To define a volume set with vsname USERSET; with members USERSET (master volume, and MEM2, of type 
HP7920; and class (vcnamevname) CLASS1 : USERSET, MEM2, enter: 

;NEWVSET USERSET;MEMBERS=USERSET: HP7920,MEM2:HP7920;CLASS=CLASS1 ;USERSET,MEM2 
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:OPENQ 



Opens the spool queue for a specified logical device or device class. This command is supported by the 
G. 00. 00 and later releases of MPE. 

SYNTAX 



•OPENO {lde ° } 

,0PENQ {deoclass} 



PARAMETERS 

Ideo The logical device number of the spooled device. 

deoclass The device class name of the spooled device; devclass must begin with a 

letter and consist of eight or fewer alphanumeric characters. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be executed only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

: OPENQ enables the Operator to control the spool queue of a specified device or device class without 
affecting the operation of the spooler process. It also gives the Operator access to spool queues for which 
no spooler or physical device exists. 

Since spoolfiles can be created faster than they are processed, you may want to issue a :SHUTQ command, 
to clear the backlog of files in the queue, and then re-open it with an : OPENQ command when the queue 
is clear. 

: OPENQ also serves as an option to the :STOPSPOOL command. The :ST0PSP00L and the :SHUTQ 
commands are documented in this section. 

EXAMPLE 

To open the spool queue for logical device 6, enter: 
: OPENQ 6 



I 
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:OUTFENCE 



Defines the minimum priority an output spoolf ile needs in order to be printed. 

SYNTAX 




PARAMETERS 

out put priority A number between 1 and 1 4, inclusive. A larger number is more limiting. 

Ideo The logical device number of an output device. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It is ex- 
ecutable only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

: OUTFENCE controls the processing of all output spoolf iles by establishing a numerical limit, or "fence", 
that, along with each spoolfile's outputpriority, determines whether a file will be printed or deferred. 
Individual spoolf iles which are READY will be printed only if their outputpriority is higher than the cur- 
rent outf ence. To prevent any spoolf iles from being printed, set the outfence to 1 4. To defer a subset of 
spoolf iles, set the outfence higher than the outputpriority of any spoolf ile in the group. 

You may wish to alter the printing priority of a single file without affecting the entire system. If that is 
the case, change the outputpriority of the specific spoolfile with the rALTSPOOLFILE command. (Refer to 
discussion of :ALTSPOOLFILE in this section.) 

EXAMPLES 

To defer all output spoolf iles except those waiting to be printed by Idev 6, usually configured (the system 
line printer), set the global outfence to 1 4 and the outfence of Idev 6 to 7, as shown below: 

: OUTFENCE 14 

: OUTFENCE 7;LDEV=6 
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To display the new global out put priority and the out put priority of logical device 6, execute the :SHOWOUT 
command, as in the example below. Note that the summary statistics at the bottom of the listing will 
immediately reflect the new OUTFENCE, but individual entries for each output spoolfile may not. Once the 
currently ACTIVE spoolfile is finished, however, no files directed towards a device other than Idev 6 will 
become ACTIVE. 



:SHOWOUT 












DEV/CL 

6 

6 

SLOWLP 

20 

11 


DFID 

#0999 

#01030 

#01029 

#01001 

#01022 


JOBNUM 

#J19 

#S77 

#S71 

#S60 

#S33 


FMAME STATE FRM 
$STDLIST OPENED 
EDLIST OPENED 
OUT READY 
$STDLIST OPENED 
GAL LIST READY 


SPACE RANK PR I 
512 8 
512 8 
232 1 7 

768 1 7 


#c 

1 
1 

1 

1 



11 FILES: 

1 ACTIVE 

1 READY; INCLUDING 1 SPOOFLES, DEFERRED 

9 OPENED; INCLUDING 2 SPOOFLES 

LOCKED; INCLUDING SPOOFLES 

4 SPOOFLES: 2024 SECTORS 

OUTFENCE = 14 

OUTFENCE = 7 FOR LDEV 6 

To reset the outfence for all output spoolfiles, enter: 
: OUTFENCE 6 
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:PARTBACKUP 



Performs a backup of MPE and all of the files that have been modified since the last full backup for 
G.01.00 and later releases of the MPE operating system. 

SYNTAX 



:PARTBACKUP [dumptape] [^auxlistfile] 



PARAMETERS 

dumptape 
auxlistfile 



Specifies the magnetic tape destination for the backup. If dumptape is 
specified, it must be backreferenced to a previous :FILE command or file 
equates to the formal file designator DUMPTAPE. The default is TAPE. If 
there is no device class TAPE, the device class CTAPE will be used. 

Actual file designator of the output file (device) to which all listings 
requested during the execution of the backup process are written. The 
default is $STDLIST. 



USE 

This command may be issued from a Session or Job, but not 
execution). It requires System Supervisor (OP) capability. 



in BREAK. It is Breakable (suspends 



OPERATION 

This command starts the backup process and copies MPE and all of the files that have been modified since 
the last full backup. The two commands : PARTBACKUP and tFULLBACKUP provide an alternative to 
going through the rSYSDUMP dialog. The only user interaction required with these commands is 
mounting tapes or serial discs and replying to any mount requests. These replies are unnecessary, however, 
if the devices are configured as AUTO REPLY. 

During the backup, : PARTBACKUP will display messages at one minute intervals to report its progress: 

STORE OPERATION IS 27% COMPLETE 



EXAMPLES 

In the following example the first :FILE command defines DUMP as a magnetic tape file. The second 
:FILE command defines LIST as a line printer. The TAPE and LP parameters are device class names 
arbitrarily defined during the previous system configuration. 

FILE DUMP;DEV=TAPE 
FILE LIST;DEV=LP 
PARTBACKUP *DUMP,*LIST 



OCT 1988 
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The following will be displayed at the Console: 

?17:08/#s278/89/LDEV* FOR "DUMP" ON TAPE (NUM)? 

In the following example, a file equation with the formal file designator of DUMPTAPE was previously en- 
tered (e.g. :FILE DUMPTAPE; DEV=SYSTAPE). As a result, the user may omit the first parameter, and the 
backup will go to the device class SYSTAPE. 

:PARTBACKUP,*LIST 

The following will be displayed at the Console: 

?11:08/#S278/89/LDEVt FOR "DUMPTAPE" ON SYSTAPE (NUM)? 

In the following example, the dumptape is not specified, and there is no file equation for DUMPTAPE. A 
temporary file equation (FILE DUMPTAPE ;DEV=TAPE) will be used. 

: PARTBACKUP 

The following will be displayed at the Console: 

?11:08/#S278/89/\.DZV# FOR "DUMPTAPE" ON TAPE (LDEV)? 
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:PASCAL 

Compiles a PASCAL program. PASCAL/3000 is not part of the HP 3000 Fundamental Operating 
Software and must be purchased separately. 

SYNTAX 



: PASCAL [ text file] [ , [uslfile] Ulistfile) ] 
[||| I N FO=quotedst ring ] 



PARAMETERS 

text file Actual file designator of the input file from which the source program is 

read. This can be any ASCII input file. Formal file designator is PASTEXT. 
Default is $STDIN. 

uslfile Actual file designator of the USL file to which the object code is stored. 

This can be any binary output file with a file code of USL or 1024. Its 
formal file designator is PAS USL. If the uslfile parameter is omitted, the 
object code is saved to the temporary file $OLDPASS. If entered, this pa- 
rameter indicates that the USL file was created in one of four ways: 

• By using the MPE :SAVE command to save the default USL file 
$OLDPASS, created during a previous compilation. 

• By building the USL with the MPE Segmenter -BUILDUSL command. 
Refer to the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file and specifying the MPE : BUILD command 
with a file code of USL or 1 024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

list file Actual file designator of the file to which the program listing is written. 

This can be any ASCII output file. Formal file designator is PASLIST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command ( PASTEXT, 
PASUSL, and PASLIST) cannot be backreferenced as actual 
file designators in the command parameter list. For further 
information, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the :FILE command. 
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quotedstring A sequence of characters between two single quotation marks (apostrophes) 

or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is con- 
sidered part of the string, and, therefore, not the terminating delimiter. 

\WTO=quotedstring is used in the PASCAL programming language to pass 
initial compiler options to a program. PASCAL/ 3 000 brackets the 
quotedstring with dollar signs and places it before the first line of source 
code in the text file. For more information, refer to the : RUN command in 
this section. 

USE 

This command may be issued from a Session or a Job. It may not be used from a Program or in BREAK. 
It is Breakable (suspends execution). 

OPERATION 

The : PASCAL command compiles a PASCAL program and stores the object code in a User Subprogram 
Library (USL) file on disc. If textfile is not specified, MPE expects the source program to be entered from 
your standard input device. If you do not specify a list file, MPE sends the program listing to your stan- 
dard list device and identifies it by the formal file designator, PAS LI ST. 

If you create the USL prior to compilation, you must specify a file code of USL or 1024. If you omit the 
uslfile parameter, the object code is saved in the temporary file domain as $OLDPASS. To keep it as a 
permanent file, you must save $OLDPASS under another name. 

EXAMPLES 

The following example compiles a PASCAL program entered from the standard input device and stores 
the object code in the USL file $OLDPASS. The listing is then sent to the standard list device. 

; PASCAL 

The next example compiles a PASCAL program contained in the disc file PASCSRC, and stores the object 
code in the USL file PASCOBJ. The program listing is stored in the disc file LISTFILE. 

t PASCAL PASCSRC, PASCOBJ.LISTFILE 

ADDITIONAL DISCUSSION 

PASCAL/3000 Reference Manual (32106-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:PASCALGO 

Compiles, prepares, and executes a PASCAL/ 3000 program. PASCAL is not part of the HP 3000 
Fundamental Operating Software and must be purchased separately. 



SYNTAX 



: PASCALGO [ text file] [Mlistfile] 
[§jUFO=quotedstring] 



PARAMETERS 

text file 

list file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is PASTEXT. 
Default is $STDLIST. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is PAS LI ST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command 
( PASTEXT , and PAS LI ST) cannot be backreferenced as ac- 
tual file designators in the command parameter list. For 
further information, refer to the "Implicit :FILE Commands 
For Subsystems" discussion of the :FILE command. 



quotedstring 



A sequence of characters between two single quotation marks (apostrophes) 
or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is con- 
sidered part of the string, and, therefore, not the terminating delimiter. 

lHFO=quotedstring is used in the PASCAL programming language to pass 
initial compiler options to a program. PASCAL/ 3000 brackets the 
quotedstring with dollar signs and places it before the first line of source 
code in the text file. For more information, refer to the : RUN command in 
this section. 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK. It 
is Breakable (suspends execution). 
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OPERATION 

The : PASCALGO command compiles, prepares, and executes a PASCAL program. If textfile is omitted, 
MPE expects input from your standard input device. If you do not specify listfile, MPE sends the program 
listing to the formal file designator PASLIST (default is $STDLIST). 

The USL file created during the compilation is the system defined temporary file $OLDPASS, which is 
passed directly to the Segmenter. It can only be accessed if you do not use the default for progfUe. This 
is because the Segmenter also uses $OLDPASS to store the prepared program segments, overwriting any ex- 
isting temporary file of the same name. 

EXAMPLES 

To compile, prepare, and execute a PASCAL program entered from your standard input device, with the 
program listing sent to your standard list device, enter: 

: PASCALGO 

To compile, prepare, and execute a PASCAL program from the disc file PASCSRC and send the program 
listing to the file LISTFILE, enter: 

: PASCALGO PASCSRC , LISTFI LE 

ADDITIONAL DISCUSSION 

PASCAL/3000 Reference Manual (32106-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:PASCALPREP 



Compiles and prepares a PASCAL/3000 program. PASCAL is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 



SYNTAX 



;PASCALPREP [text file] IMprogfile] [^listfile] 
\MlNFO=quotedstring] 



PARAMETERS 

text file 
prog file 



listfile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is PASTEXT. 
Default is $STDIN. 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When progfile is omitted, the MPE Segmenter creates the 
program file, which will be stored in the temporary file domain as 
$OLDPASS. If you do create your own program file, you must do so in one 
of two ways: 

• By using the MPE : BUILD command, and specifying a file code of 1 029 
or PROG, and a numextents value of 1. This file is then used by the 
: PREP command. 

• By specifying a nonexistent file in the progfile parameter, in which 
case a job/session temporary file of the correct size and type is created. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. Formal file designator is PAS LI ST. 
Default is $STDLIST. 



NOTE 



The formal file designators used in this command ( PASTEXT 
and PAS LI ST) cannot be backreferenced as actual file 
designators in the command parameter list. For further in- 
formation, refer to the "Implicit :FILE Commands For 
Subsystems" discussion of the :FILE command. 
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quotedstring A sequence of characters between two single quotation marks (apostrophes) 

or between two double quotation marks. You may use the delimiter as part 
of the string so long as the delimiter appears twice. Any occurrence of two 
single quotation marks in a row, or two double quotes in a row, is con- 
sidered part of the string, and, therefore, not the terminating delimiter. 
INF O=quotedstring is used in the PASCAL programming language to pass 
initial compiler options to a program. PASCAL/ 3 000 brackets the 
quotedstring with dollar signs and places it before the first line of source 
code in the text file. For more information, refer to the : RUN command in 
this section. 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The :PASCALPREP command compiles and prepares a PASCAL program into a program file on disc. If 
you do not specify textfile, MPE expects input from the current input device. If you do not specify listfile, 
MPE sends the listing output to the formal file designator PAS LI ST (default $STDLIST). The USL file 
$OLDPASS, created during compilation, is a temporary file passed directly to the Segmenter. You may ac- 
cess it only if you do not use the default for progfile. This is because the Segmenter also uses $OLDPASS 
to store the prepared program segments, overwriting any existing temporary file of the same name. 

EXAMPLES 

The following example compiles and prepares a PASCAL program entered through your standard input 
device and stores the prepared program segments in the file $0LDPASS. The listing will be printed on 
your standard list device. 

: PASCALPREP 

To compile and prepare a PASCAL source program from the source file PASCSRC, storing it in PASCPROG, 
and sending the listing to your standard list device, enter: 

;PASCALPREP PASCSRC, PASCPROG 



ADDITIONAL DISCUSSION 

PASCAL/3000 Reference Manual (32106-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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PASSWORD 



Allows you to establish or change your own user password. 

SYNTAX 



: PASSWORD 



PARAMETERS 

None. 

USE 

You can use this command from a Session, Job, Program, or in BREAK. It is not Breakable (a BREAK does 
not abort execution). 

OPERATION 

The : PASSWORD command has two purposes: to allow you to create or change your own user password, 
and to ensure that user passwords are private. You no longer need Account Manager or System Manager 
capabilities to change your own password. . 

A user password must consist of one to eight alphanumeric characters, beginning with an alphabetic 
character. To enhance system security, the System Manager may configure a system -wide minimum 
password length from to 8. The minimum length requirement does not apply to existing passwords. If 
you select a new password that does not meet the length requirement, you see the following message: 

MINIMUM PASSWORD LENGTH IS ! CHARACTERS. (CIERR 763) 

If your password length is incorrect, see your System Manager for assistance. The default minimum 
length is 0. 

To execute the : PASSWORD command, you must enter the old user password before you a new user pass- 
word prompt will appear. The old user password is entered incorrectly, an error will result and the com- 
mand will abort. When entering the new user password, you will be requested to enter the password a 
second time for verification. If the second password differs from the first, an error will occur and the 
command will abort. 

The passwords you will type (old and new) are not displayed on the terminal screen. If the old password is 
entered incorrectly, an error will occur, in addition to an error statement as shown below: 

PASSWORD WAS NOT CHANGED. 
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EXAMPLE 

To change a user level password from "SMITTY" to "JONES" the dialog would be as follows: 

: PASSWORD 

ENTER OLD USER PASSWORD: SMITTY 
ENTER NEW USER PASSWORD: JONES 
ENTER NEW USER PASSWORD AGAIN: JONES 
PASSWORD WAS CHANGED SUCCESSFULLY. 

ADDITIONAL DISCUSSION 

MPE V Account Structure and Security (32033-90136) 
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:PREP 



Prepares program from a User Subprogram Library (USD file onto a program file. 



SYNTAX 



:PREP usl file, prog file 




[;ZERODB] 


[;CAP=eapIist] 


[;PMAP] 


[;RL= filename] 


[ ;MAXDATA=segrsize] 


[ \ PA7CH=patchsize] 


[ ;ST kCK= stacksize] 


[;NOSYM] 


[\D\-=dlsize] 


r {;FPMAP ), 
L {;NOFPMAP) J 



PARAMETERS 

uslfile 
prog file 



ZERODB 



PMAP 



segsize 



stacksize 



OCT 1988 



Actual designator of User Subprogram Library (USL) file onto which 
program has been compiled. 

Actual designator of program file onto which prepared program segments 
are written. This can be any binary output file. This program file must be 
created in one of two ways: 

• By creating a new file with the MPE : BUILD command with a file code 
of PROG or 1 029, and one extent. 

• By specifying a nonexistent file in the progfile parameter, in which case 
a file of the correct size and type is created. This file is a job 
temporary file. 

Request to initialize to zero the initially defined, user-managed (DL-DB) 
area of the stack, and uninitialized portions of the DB-Q (initial). Default 
is that these areas are not affected. 

Request to produce a descriptive listing of the prepared program on file 
whose formal designator is SEGLIST. If no :FILE command is found 
referencing SEGLIST, listing is produced on $STDLIST. Default is no 
listing. 

Maximum permitted stack area (Z-DL) in words. This parameter should be 
included when it is expected that the size of DL-DB or Z-DB areas will be 
changed during program execution. Default is that MPE assumes that these 
areas will not change. 

Size of initial local data area (Z-Q initial) in stack, in words. This value, if 
specified, must be between 511 and 32767 words. This parameter overrides 
the default stacksize estimated by MPE Segmenter. 
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dlsize 



caplist 



DL-DB area to be initially assigned to stack. This area is of interest mainly 
in programmatic applications. In all cases, the DL-DB area is rounded 
upward so that the distance from the beginning of the stack data segment 
to the DB-address is a multiple of 128 words. Default is estimated by the 
MPE Segmenter. 

Capability -class attributes associated with program, specified as 
two-character mnemonics. If more than one mnemonic is specified, each 
must be separated from its neighbor by a comma. The mnemonics are: 



I A Interactive Access 

BA Local Batch Access 

PH Process Handling 

DS Data Segment Management 

MR Multiple Resource Management 

PM Privileged Mode 



filename 



patchsize 



NOSYM 



Note that you can specify only those capabilities as assigned by the Account 
Manager or System Manager. Default is I A and BA 

Actual designator of RL file to be searched to satisfy external references 
during preparation. This can be any permanent binary file of type RL. It 
need not belong to your logon group, nor have a reserved, local name. This 
file, to which you must have READ and LOCK access, yields a single 
segment that is incorporated into the segments of the program file. For 
more information, refer to the MPE Segmenter Reference Manual 
(30000-9001 1). Default is that no library is searched. 

Specifies size of patch area. This size will apply to all segments within the 
program file. 

Suppresses the symbolic debug option. Refer to the HPToolset Reference 
Manual (32350-90001). 



FPMAPor NOFPMAP 



Includes or excludes the internal PMAP information. FPMAP is a request to 
have internal PMAP information included in the program. NOFPMAP 
excludes PMAP information from the program when the system FPMAP or 
job/session FPMAP is on. If the symbolic debug option is invoked, default is 
FPMAP. Otherwise the default is NOFPMAP 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK, 
is Breakable (suspends execution). 



It 



2-245 



OPERATION 

The : PREP command prepares a compiled source program for execution. Unless you prepare the program 
onto a previously -created program file, this command will create a program file of the appropriate format 
for you in the job/session temporary file domain. In fact, it is recommended that you specify a 
nonexistent program file in the :PREP command. This allows MPE to create a file of optimum size and 
characteristics. (Refer to EXAMPLE section.) 

A compiled program is prepared by searching a relocatable library (RL) to satisfy references to external 
procedures required by the program. When the program is prepared, such procedures are linked to the 
program in the resulting program file. To use a relocatable library (RL) via the : PREP command, the user 
requires READ and LOCK access to the file. 

EXAMPLE 

To prepare a program from the USL file USLX to the currently nonexistent program file PROGX, enter: 

: PREP USLX,PROGX ** Prepares program into program file PROGX. ** 
: SAVE PROGX ~ ** Saves program file. ** 

You will obtain the best results by allowing the MPE Segmenter to create your program file; however, you 
can create your own program file in the permanent file domain by using the : BUILD command. When 
you do this, you must be sure to specify a file code of "PROG" or "1029" and a numextents parameter 
value of 1. The following BUILD command creates such a file, which is then used by the : PREP command. 

: BUI LP PROGX ; C0DE= PROG; PI SC=,1 
: PREP USLY,PFILE 

To prepare a program from the USL file named USLZ and store it in a program file named PROGZ, list the 
prepared program, assign a stacksize of 51 1 words, and assign Local Batch Access (BA) capability only 
for the program, enter: 

; PREP USLZ, PROGZ ;PMAP;STACK=5 11 ;CAP=BA 

ADDITIONAL DISCUSSION 

For a complete tutorial refer to the MPE Segmenter Reference Manual (30000-9001 1) 
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:PREPRUN 



Prepares and executes a compiled program. 

SYNTAX 



:PREPRUN uslfile[\entrypoint] 

[pOPRIV] 

IlPMAP] 

[v DEBUG] 

[ILMAP] 

[jpERODB] 

[|MAXDATA=se^s£ze] 

\MPkR\\=parameternum\ 

[|STACK=stac^st2e ] 

[§DL=rfZs£ze] 

{G} 
[1LIB={P}] 
<S> 

[%CkP=oapabilitylist ] 



[!||RL= filename] 

[|||NOCB] 

\MlNFO=quotestring] 



{ *formaldesig } 
\mroiH=[{fileref >]] 

{$NULL } 



{*formaldesig } 
[!)STDLIST={/tZeref [fNEW]}]] 
{$NULL > 

\^ > PCTCH=patchsize] 

[pOSYM] 

r {||FPMAP }, 
l {pOFPMAP} J 



PARAMETERS 

uslfile 

en try point 



NOPRIV 



Actual file designator of the USL file to which the program has been 
compiled. 

Contains a character string, terminated by a blank, specifying the entry 
point (label) in the program where execution is to begin when the program 
is executed. The entrypoint parameter may be the primary entry point or 
any secondary entry point in the program's outer block. Default is primary 
entry point. 

Declaration that the program segments will be placed in non privileged 
(user) mode. This parameter is for programs prepared with Privileged Mode 
capability and make them accessible to non privileged users. Normally, 
program segments containing privileged instructions are executed in 
Privileged Mode only if the program was prepared with Privileged Mode 
(PM) capability class. (A program containing legally compiled privileged 
code, placed in nonprivileged mode, may abort when an attempt is made to 
execute it.) 
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PMAP 



DEBUG 



LMAP 



ZERODB 



segstze 



parameternum 
stacksize 

dlsize 



If NOPRIV is specified, all segments are placed in nonprivileged mode. 
(Library segments are not affected because their mode is determined in- 
dependently.) Default is that segments of a Privileged mode program will 
remain in Privileged Mode. 

Request to produce a descriptive listing of the prepared program to a file 
whose formal file designator is $SEGLIST. If $SEGLIST is not found in a 
: FILE command, the listing is produced on the current list device. Default 
is no listing. 

Request to issue a DEBUG call before the first executable instruction of the 
program. Unless the user has Read and execute access to the program file, 
this parameter is ignored. If Privileged Mode (PM) capability has been as- 
signed, the user is put into privileged mode DEBUG. If not, the user is put 
into user mode DEBUG. Default is that the DEBUG call is not issued. 

Request to produce a descriptive listing of the allocated (loaded) program to 
a file whose formal file designator is LOADLIST. If no :FILE command 
referencing LOADLIST is found, the listing is produced on $STDLIST. 
Default is no listing. 

Request to initialize to zero the initially defined user managed (DL-DB) 
area, and uninitialized portions of the DB-Q (initial) area. Default is that 
these areas are not affected. 

Maximum permitted stack area (Z-DL) in words. This parameter should be 
included when you expect that the size of DL-DB or Z-DB areas will be 
changed during program preparation or execution. Regardless what you 
specify, MPE may change the segsize to accommodate table overflow 
conditions. 

If you prepare your program with a segsize less than the configured mini- 
mum, the value is rounded up to the minimum or the amount needed by the 
program (as calculated by the Segmenter). The maximum actual segsize 
permitted a program is 32,767 words. You may prepare your program 
with a segsize larger than necessary so long as this maximum is not ex- 
ceeded. If the specified segsize does exceed the maximum, it will be 
rounded down to 32 , 767 words. 

An integer containing a parameter to be passed to the new program (ac- 
cessed through Q-4 of the outer block). 

Size of local data area, Z-Q (initial), in the stack, in words. If it is specified, 
this value must be between 511 and 32,767 words. The default is es- 
timated by the MPE Segmenter. 

DL-DB area to be initially assigned to stack. Due to system logging con- 
siderations, the DL-DB area is always rounded upward, so that the distance 
from the beginning of the stack data segment to the DB-address is a multi- 
ple of 128 words. The value you specify must be between -1 and 32,767 
words. The default is estimated by the MPE Segmenter. 
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G, P, or S 



capabilitylist 



filename 



NOCB 



quotedstring 



STDIN 



Searches the segmented procedure libraries of the program file's group and 
account. The G option searches the group library, account library, then the 
system * rrary. The P option searches the account library then system 
library, i he S option searches the system library for external references to 
segmented procedures. Default is S. 

Capability class attributes associated with the program, specified in 
two-character mnemonics. If more than one mnemonic is specified, each 
must be separated from its neighbor by a comma. The mnemonics are: 

I A Interactive Access 

BA Local Batch Access 

PH Process Handling 

DS Data Segment Management 

MR Multiple Resource Management 

PM Privileged Mode 

You can specify only those attributes that you possess through assignment 
by the Account Manager or the System Manager. Default is I A and BA 

Actual file designator of the relocatable library (RL) file to be searched to 
satisfy external references during preparation of the program. This can be 
any permanent file of type RL, to which you must have READ and LOCK 
access. It need not belong to the logon group, nor does it require a reserved, 
local name. This file yields a single segment that is incorporated into the 
segments of the program file. Refer to the MPE Segmenter Reference 
Manual (30000-9001 1) for a description of RL files. Default is that no 
library is searched. 

Request that the file system not use stack segment (PCBX) for its control 
blocks, even if sufficient space is available. This permits you to expand 
your stack (with the DLSIZE or ZSIZE intrinsics) to the maximum possible 
limit at a later time. It will, however, cause the File Management System 
to operate more slowly for this program. 

A sequence of characters between two single quotation marks (apostrophes) 
or two double quotation marks. You may use the delimiting character as 
part of the string so long as the delimiter appears twice. Any occurrence of 
two single quotes, or two double quotes in a row, is considered part of the 
string, and, therefore, not the terminating delimiter. 

; I HFO=quotedstring is used in some programming languages (e.g. COBOLII, 
Pascal) to pass compiler options to a program. These options will appear 
before the first line of source code in the text file. For more information, 
refer to the : RUN command in this section. 

This parameter allows the user to specify the file to be used as $STDIN by 
the program being executed. If omitted, or if nothing is specified after the 
equal sign, such as ";STDIN=", then STDIN defaults to the job or session's 
standard input device. You may use one of the following subparameters 
withSTDIN=: 

*formaldesig The formal file designator for a file previously specified 
in a file equation. 



file re f 



The name of an existing permanent disc file. 
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STDLIST 



I 



$NULL The actual file designator of a system defined file that is 

always treated as an empty file. 

When referenced by a program as $STDIN, that program 
receives only an end -of -file indication when accessed. 
When referenced by a program as $STDLIST, the as- 
sociated write request is accepted by MPE, but no physi- 
cal output is actually performed. Thus, $NULL can be 
used to discard unneeded output from an executing 
program. 

This parameter allows the user to specify the file to be used as $STDLIST 
by the program being executed. If omitted, or if nothing is specified after 
the equal sign, such as ";STDLIST=", then STDLIST defaults to the job or 
session's standard list device. This parameter has the same subparameters as 
STDIN, but you may also specify the keyword NEW. 



NEW 



The name to be assigned to a job/session temporary disc 
file created with the system defaults. The system 
defaults of the new file are fixed length ASCII 132-byte 
records with a maximum file size of 1 023 records. 



patchsize 



NOSYM 



FPMAPor NOFPMAP 



Specifies the size of the patch area. This size will apply to all segments 
within the program file. The value you specify must be within -1 and 
1 6 , 380 words. 

Suppresses the symbolic debug option. Refer to the HPToolset Reference 
Manual (32350-90001) for more information. 

Includes or excludes the internal PMAP information. FPMAP is a request to 
have internal PMAP information included in the program. NOFPMAP ex- 
cludes PMAP information from the program when the system FPMAP or 
job/session FPMAP is on. If the symbolic debug option is invoked, default is 
FPMAP. Otherwise the default is NOFPMAP 



USE 

This command may be issued from a Session or Job. It may not be used from a Program, or in BREAK. It 
is Breakable (suspends execution). 

OPERATION 

The : PREPRUN command prepares and executes a program compiled in a USL file. Both relocatable (RL) 
and segmented (SL) libraries are searched during the preparation process to satisfy external references. 

The USL file created during compilation is a system defined temporary file, $0LDPASS, which is passed 
directly to the Segmenter. It can be accessed only if you do not use the default for progfile. This is be- 
cause the Segmenter also uses the file $OLDPASS to store the prepared program segments, overwriting any 
existing temporary file of the same name. 
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EXAMPLES 

To prepare and execute a program from the USL file XUSL, with no special parameters declared, enter: 
: PREPRUN XUSL 

To obtain a descriptive listing of the prepared program, and a listing of the allocated (loaded) program 
enter: "" ' 

: PREPRUN XUSL;PMAP;LMAP 

To prepare and execute a program form the USL file UBASE that begins execution at the entry point 
RESTART, that has a stacksize of 800 words and searches an RL file named LIBA, enter: 

: PREPRUN UBASE, RESTART;STACK=800;RL=LIBA 

The following example prepares and runs a program with $STDIN set to the existing disc file INPUT. 
$STDLIST is set to the line printer: 

: FILE LPFILE;DEV=LP 

: PREPRUN TESTPROG;MAXDATA=10000;STDIN=INPUT;STDLIST=»LPFILE 

The next example also uses the "STDIN=" and "STDLIST=" parameters to prepare and run a program. This I 

time, a file equation is used to set $STDIN to INPT, and to set STDLIST to the temporary disc file I 

RESULTS (which is automatically created by the : RUN command). | 

: FILE INFILE=INPT t OLD: 

: PREPRUN TESTPROG;DEBUG;STDIN=«INFILE;STDLIST=RESULTS,NEW 

The following example of the rPREPRUN command uses the "INFO" parameter to pass a string to the 
program: 

; PREPRUN MYPROG;MAXDATA=2000;INFO="A test with ""and"" characters" 

Note that the delimiting character is doubled within the string so that it will appear on the printout as 
follows: 

A test with "and" characters 

ADDITIONAL DISCUSSION 

For a full tutorial, refer to the MPE Segmenter Manual (30000-9001 1) 
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:PTAPE 



Reads a paper tape without X-OFF control. 

SYNTAX 



: FT APE filename 



PARAMETERS 

filename Name of existing ASCII file on disc, to which input data is to be written 

from a paper tape. Normally, this is a file with variable length records; the 
record size specified must be large enough to contain the largest paper tape 
record. 

USE 

This command may be issued from a Session, Program, or in BREAK. It may not be used in a Job. It is 
not Breakable. 

OPERATION 

The : PTAPE command permits programs to read input from a terminal that is coupled to a paper tape 
reader/punch when the X-OFF control character is not punched on the tape. (The X-OFF character, on 
a tape, turns off the tape reading mechanism. This character normally appears following the carriage 
return/line feed character combination used to delimit each record.) The : PTAPE command transfers all 
data from the tape to an ASCII file (named in the filename parameter) on disc. It stores all records to the 
disc file in the order read from the tape, but deletes all carriage return and line feed characters. (If the 
tape does contain X-OFF characters, the operation also deletes these. The X-OFF characters are not ig- 
nored by the tape reader, however, and so you must restart the reader after each X-OFF is read. ) The in- 
put terminates when the Y° character is encountered on the tape or entered from the terminal, Control 
returns to the keyboard. The input data now can be read from the disc file by any program. 

Note that the : PTAPE command is required only for input from HP tape readers associated with terminal 
keyboards. 

You cannot use the : PTAPE command to copy tapes containing more than 32,767 bytes of information. 
If you attempt to copy such tapes, MPE will read only the first 32 , 767 bytes on the tape and will then 
terminate the operation. 

EXAMPLE 

To copy input from a paper tape to a disc file named TAPEFILE first, create an appropriate file with the 
MPE : BUILD command, and follow it with the : PTAPE command: 

; BUILD TAPEFILEiREC^SO^.V.ASCII 
: PTAPE TAPEFILE 
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:PURGE 



Deletes file from system. 



SYNTAX 




PARAMETERS 

fi I ereference 



TEMP 



Actual file designator of file to be deleted, in this format: 

filename[flockword] [.groupname[ .acctname] ] 

To delete the file, you must have WRITE access to it. 

Indicates that the file is a temporary file in the job/session temporary file 
domain. You must enter this parameter to delete a temporary file. 
Default is that a permanent file is assumed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

This command deletes a disc file from the system. If the volume set on which the file resides is not 
mounted, this command will generate an implicit mount request. If a mount follows, the purge will be 
done. 

If the file does not exist in the domain specified (temporary or permanent), the following message is 
displayed: 

FILE filename NOT FOUND, NO PURGE DONE. (CIWARN 383) 

To purge a KSAM file, run KSAMUTIL.PUB.SYS, using the > PURGE subcommand. Purging KSAM files 
with the MPE : PURGE command is not recommended. 
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EXAMPLES 

To delete the permanent file PFILE, enter: 

: PURGE PFILE 
To delete the temporary file TFILE , enter: 

: PURGE TFILE.TEMP 

ADDITIONAL DISCUSSION 

MPE File System Reference Manual (30000-90236) 
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:PURGEACCT 



director 8 an aCC ° Unt and itS gr ° UPS and USe " fr ° m thC SyStCm directory or from the specified volume set's 

SYNTAX 



PURGEACCT acctname [||VS=yoZset] 



PARAMETERS 

acctname 

volset 



Name of the account to be deleted. This name must contain from one to 
eight alphanumeric characters, beginning with an alphabetic character. 

Volume set or volume class reference which, when fully qualified is in the 
following form: 

vcsid.groupname . acctname 

The vcsid parameter refers to a previously defined volume set or volume 
class. When the volset is specified, the volume set or volume class must be 
mounted, or the : PURGEACCT command will fail. When volset parameter is 
specified, the account will be removed from the volume set directory, and 
not the system directory. 



USE 



This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable A user 
must have System Manager (SM) capability to execute this command. 

OPERATION 

The System Manager uses the : PURGEACCT command to eliminate an entire account from the system. 
When : PURGEACCT is executed during a session, MPE displays a verification request to ensure that the 
wrong account is not deleted accidentally. Respond "YES" or "NO" to the message: 

ACCT acctname TO BE PURGED? 

No verification message is printed when the : PURGEACCT is entered in a job. 

The : PURGEACCT command removes every user not currently logged on and every group/file not in use 
The order in which entries are purged is: users, volume set definitions, files, groups, and finally the ac- 
count. If the command is executed while the account is in use, the account remains on the system: active 
users, 8«>ups. and files are not purged from the account. To completely purge an account, you must ex- 
ecute : PURGEACCT when the account is inactive. 
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CAUTION 



Do not attempt to purge the SYS account. The account SYS 
cannot be completely purged, but you can destroy critical 
files by attempting to do so. If you execute rPURGEACCT 
SYS, all groups except PUB will be purged, all users except 
the System Manager will be purged, and all inactive files 
and system files in the PUB group will be purged. 



I 



EXAMPLE 

To remove an account named ACCT1 , enter: 

; PURGEACCT ACCT1 

ACCOUNT ACCT1 TO BE PURGED? (YES/NO) YES 
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:PURGEGROUP 



Removes a group (and all files belonging to it) from the system, or from the specified volume set directory. 

SYNTAX 



;PURGEGROUP groupname[ .accountname] [|VS=t>oZset] 



PARAMETERS 



groupname 



accountname 



oolset 



Name of the group in the logon account to be removed. This name must 
contain from one to eight alphanumeric characters, beginning with an al- 
phabetic character. 

As System Manager you can include the account name when logged onto an 
account other than the requested account. 

Volume set or volume class reference which, when fully qualified, is in the 
form, vcsid. groupname. acctname, where vcsid refers to a previously defined 
volume set or volume class. 

If volset is specified, the volume set or volume class must be mounted or the 
: PURGEGROUP command will fail. When the volset parameter is specified, 
the group will be removed from the volume set directory, and not the sys- 
tem directory. 



USE 



This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Account Manager (AM) capability to execute this command. 

OPERATION 

Account Managers use the : PURGEGROUP command to delete a group from their account. When the com- 
mand is executed during a session, MPE displays a verification request. Respond "YES" or "NO" to the 
message: 

GROUP groupname TO BE PURGED? (YES/NO) 

No verification message is printed if the : PURGEGROUP command is entered in a job. 

If the group resides on a private volume, the command will succeed only if the group's home volume set is 
mounted. 

The order in which entries are purged is: volume set definitions, files, and finally the group. If no files in 
the group are in use, and the group itself is not in use, the : PURGEGROUP command will remove the entire 
group. Otherwise, only inactive files will be removed. To completely purge the group in this case, re- 
enter the : PURGEGROUP command when neither the group nor its files are in use. 
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CAUTION 



Do not attempt to purge the PUB group of the SYS account. 
The public group of the system account, PUB. SYS , cannot 
be completely purged. If you specify this group in the 
groupname parameter, all non -system and inactive files will 
be purged, which will seriously impair the proper function- 
ing of the entire system. 



EXAMPLE 

To purge a group named GROUP1, enter: 

t PURGEGROUP GR0UP1 

GROUP GROUP1 TO BE PURGED? (YES/NO) YES 
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PURGEUSER 



Removes a user from an account. 

SYNTAX 



PURGEUSER user[.accountname] 



PARAMETERS 

user 
accountname 



Name of the user to be deleted. 

As System Manager you can include the account name when logged onto an 
account other than the requested account. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Account Manager (AM) capability to execute this command. 

OPERATION 

Account Managers use the : PURGEUSER command to delete a user from their account. You are asked to 
verify the command only when it is executed during a session, and not from a job. To do so, respond "YES" 
or "NO" to the message: 

USER user TO BE PURGED? (YES/NO) 

An attempt to purge a user currently logged onto the system will fail, and an explanatory message will be 
displayed. This user will not be affected until the next logon. An attempt to purge MANAGER. SYS will 
always fail, since this user can never be purged. 

If files created by a purged user remain after the user is purged from the system, the System Manager can 
remove them with the the : PURGEACCT command, or the Account Manager can eliminate them by execut- 
ing : PURGEGROUP. 



EXAMPLE 

To remove a usernamed USER1, enter: 

; PURGEUSER USER1 

USER USER1 TO BE PURGED? (YES/NO) YES 
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:PURGEVSET 

Deletes an existing volume set. 

SYNTAX 




PARAMETERS 

Vsname Name of an existing volume set or volume class. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have Create Volumes (CV) capability to execute this command. 

OPERATION 

The : PURGEVSET command will not delete a volume set if it is currently in use; that is, if an explicit or 
implicit mount, has been issued. When you enter : PURGEVSET during a session, MPE displays the follow- 
ing verification message, to which you must respond "YES" or "NO". 

VOLUME SET/CLASS DEFINITION Dsname TO BE PURGED? (YES/NO) 

EXAMPLE 

To purge the volume set, USERSET , enter: 

: PURGEVSET USERSET 

VOLUME SET/CLASS DEFINITION USERSET TO BE PURGED? (YES/NO) YES 
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:RECALL/=RECALL 



Displays all pending Console REPLY messages. 

SYNTAX 



: RECALL 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console.* 

* Any user may execute : RECALL A C =RECALL may only be executed at the Console. 

EXAMPLES 

To display all pending System Console messages which require a : REPLY response, enter: 

: RECALL 

REPLIES PENDING: 

10:05/#J19/15/LDEV # FOR "L00576" ON TAPE1600 (NUM)? 

If there are replies pending, the text of the request(s) will be displayed on the Console as shown above. If 
there are no replies pending, the following message will appear on the Console: 

: RECALL 

NO REPLIES PENDING (CIWARN 3020) 



NOTE 



The =RECALL command should be used in the event that the 
: RECALL command is ineffective, or when a job or subsys- 
tem is being executed from the Console. 
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:REDO 



Allows you to edit a command entry. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, or in BREAK. It may not be used from a Program. It is 
Breakable (aborts execution). 

OPERATION 

The : REDO command has two purposes: to correct errors in the last command you entered; and two, to 
change the last command you entered to a new, correct command, thereby eliminating the need to com- 
pletely re-enter the command. 

When the :REDO command is entered, MPE displays the command to be modified and enters a mode 
similar to that of EDIT/ 3000. To edit the command, use the space bar on the terminal keyboard to posi- 
tion the cursor under the character(s) to be modified, then enter one of the following subcommands: 

D Delete. Deletes the character above the D. If D is repeated, each character above each 

D is deleted. 

I Insert. Inserts one or more characters immediately preceding the character above the 

I. The D and I subcommands can be used in conjunction to delete characters, then in- 
sert new characters. 

R Replace. Replaces the characters above the R with new characters. If one character is 

entered, the character above the R is replaced; if two characters are entered, two 
characters (the character above the R and the character to the right) are replaced. R is 
the default subcommand, except when the letter to be replaced is one of the other 
subcommands. 

L) Undo. Cancels the effect of the previous D, I, or R subcommand. Entering a U, 

[RETURN) , then another U [RETURN] , cancels all previous subcommands for this :REDO 
command and restores the line being corrected to its original form. 

Until you press IRETURNI . each of these subcommands is available to you to edit the command line. 
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EXAMPLES 

To correct an error by inserting characters, use the I subcommand: 
; SHOW SP 

UNKNOWN COMMAND NAME. (CIERR 975) 
:REDO 



SHOW SP 

10 

SHOWOUT SP 

NO SUCH FILE(S) 

OUTFENCE = 3 



** Enter the correction and press [RETURN) . ** 
** Press [RETURN) to execute the correction. ** 



To replace a character with another, use the R subcommand: 
:FILE A;REC=..0;DISC=10000,16,1;SAVE 



: EXPECTED RECORD FORMAT OF F, V OR U. 

: REDO 

FILE A;REC=,,G;DISC=10000,16,1;SAVE 

RF 

:FILE A;REC=,,F;DISC=10000,16,1;SAVE 



(CIERR 273) 



** 
** 



** MPE displays command. 

** Replace G with F. 

** Corrected command displayed. ** 

** Press [RETURNI to execute. ** 



Because R is the default subcommand, you can replace the letter C by entering only the character F in the 
correct position: 



; REDO 

FILE A;REC=,,G;DISC=10000,16,1;SAVE 

F 

FILE A;REC=,,F;DISC=10000,16,1;SAVE 



** MPE displays command. ** 

** Replace G with F. ** 

** Corrected command displayed. ** 

** Press [RETURN) to execute. ** 
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: REFUSE 



Disables jobs/sessions and/or data on a designated device. 

SYNTAX 



: REFUSE \i°l**\[ldeo] 



[DATA|] 



PARAMETERS 

JOBS Disables the : JOB (or : HELLO ) command from the designated device. 

DATA Disables the : DATA command from the designated device. 

IdeO The logical device number of the device for which :JOB (or HELLO) and 

: DATA commands are refused. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

: REFUSE prevents a device from automatically recognizing and accepting one or more of the three com- 
mands users execute to introduce jobs or sessions: : JOB , : HELLO , and :DATA The JOBS parameter in the 
: REFUSE command refers to both jobs and sessions. If neither the JOBS or DATA parameter is supplied, 
both : JOB (or : HELLO ) and : DATA commands are refused. To undo the effect of the : REFUSE command, 
use : ACCEPT. 

EXAMPLES 

To prevent logical device 35 from recognizing the : DATA command, enter: 

: REFUSE DATA ,35 
To prevent both jobs and data recognition on logical device 35 enter: 

: REFUSE 35 
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:RELEASE 



Removes all security provisions for a file with the exception of any Access Control Definitions (ACDs). 
The file will remain unsecured until the : SECURE command is issued. 

SYNTAX 



: RELEASE filereference 



PARAMETERS 

filereference Actual file designator of the file whose security provisions are to be 

suspended, written in the format: 

filename[ / locktiord] [.groupname[ .acctname] ] 

If the file has a lockword, it must be specified. If groupname. acctname is 
not specified, MPE assumes the logon group and account. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

This command removes all security provisions for a file at all levels (file, group, and account) and allows 
any user in the system unlimited access to the file unless an ACD for the file is defined. Other users will 
have access to the file until its original security provisions are restored with the : SECURE command. The 
file remains accessible after the job or session ends. It also remains accessible after a system failure, unless 
the system is restarted with a SYSDUMP tape created before the : RELEASE command was issued for the 
file. This command can be used only for permanent files on disc whose labels identify you as the creator 
of the file. In addition, the : RELEASE command will fail if the group's home volume set is not mounted. 
When the default MPE security provisions are in effect, the file must be in your logon account and must 
belong to your logon or home group. 

The : RELEASE command removes the access attributes on a file with an associated ADC, but it does not 
remove ACDs. Also, privileged files cannot be released. 

The : RELEASE command does not affect the file's lockword, if one was assigned. To check whether a file 
is secure or released, use the LISTDIR5 utility if you have version G.00.00 or later releases of the 
operating system, or the LISTDIR2 utility if you have an earlier (E/F. 00. 00 version of MPE): 
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: RUN LISTDIR5.PUB.SYS 

LISTDIR5 G.02.00 (C) HEWLETT-PACKARD CO., 1983 
TYPE 'HELP' FOR AID 

> LISTF FILE1 

FILE: FILE1.MAC.TECHPUBS 



FCODE: 


FOPTIONS: STD, ASCII , FIXED 


BLK FACTOR: 4 


CREATOR: ** 




REC SIZE: 88(B) 


LOCKWORD: «* 




BLK SIZE: 176(W) 


SECURITY- -READ: 


ANY 


EXT SIZE: 4(S) 


WRITE: 


ANY 


# REC: 4 


APPEND: 


ANY 


# SEC: 4 


LOCK: 


ANY 


# EXT: 1 


EXECUTE: 


ANY 


MAX REC: 4 


"•SECURITY 


IS OFF 


MAX EXT: 1 


COLD LOAD ID: %21604 


# LABELS: 


CREATED: FRI , 4 MAR 1988 


MAX LABELS: 


MODIFIED: FRI, 4 
4:17 PM 


MAR 1988 


DISC DEV #: 3 


ACCESSED: WED, 16 


MAR 1988 


DISC TYPE: 3 


LABEL ADR: •• 




DISC SUBTYPE: 


SEC OFFSET: %2 




CLASS: DISC 


FLAGS: NO ACCESSORS 


FCB VECTOR: %0 


%0 




>LISTF FILE2 







**FILE1 is released. ** 



FILE: FILE2.MAC.TECHPUBS 



FCODE: 
BLK FACTOR: 29 
REC SIZE: 88(B) 
BLK SIZE: 1276(W) 
EXT SIZE: 20(S) 

# REC: 849 

# SEC: 310 

# EXT: 16 
MAX REC: 849 
MAX EXT: 16 

# LABELS: 
MAX LABELS: 

DISC DEV #: 3 

DISC TYPE: 3 

DISC SUBTYPE: 

CLASS: DISC 

FCB VECTOR: %0 

>E 

END OF PROGRAM 



FOPTIONS: STD, ASCII , FIXED 

CREATOR: ** 

LOCKWORD: «» 

SECURITY- -READ: ANY 
WRITE: ANY 
APPEND: ANY 
LOCK: ANY 
EXECUTE: ANY 
♦•SECURITY IS ON 

COLD LOAD ID: %21605 

CREATED: FRI, 11 MAR 1988 

MODIFIED: FRI, 11 MAR 1988 
10:23 AM 

ACCESSED: MON, 21 MAR 1988 

LABEL ADR: «* 

SEC OFFSET: %12 

FLAGS: NO ACCESSORS 
%0 



** FILE2 is secure. ** 
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EXAMPLES 

To release all security provisions for the file named FILE1, in your logon group and account 
MAC. TECHPUBS, enter: 

:RELEASE FILE1 



If MPE fails to locate the file, the following error message is displayed: 

UNABLE TO ACCESS FILE1 .MAC. TECHPUBS. (C1ERR 356) 

If you attempt to release security provisions for a file with specified Access Control Definitions (ACDs), 
the following error message is displayed: 

AN ACD EXISTS FOR THIS FILE. (CIWARN 402) 
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:RELLOG 

Removes a logging identifier from the system. 

SYNTAX 



:RELLOG logid 



PARAMETERS 

logid The logging identifier to be removed from the system. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The :RELLOG command removes a logging identifier from the system by deleting it from the directory of 
logging identifiers. This command may be issued only by the user who created the logging identifier 
specified in the logid parameter. After :RELLOG is issued, programs containing the removed logging 
identifier will not be allowed to access the logging system. Note that you must have System Supervisor 
(OP) or User Logging (LG) capability in order to use this command. 

EXAMPLE 

To remove the logging identifier DATA LOG from the system, enter: 
; RELLOG DATALOG 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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:RENAME 



Changes identity (filename, lockword, and/or group name) of disc file. 



SYNTAX 



: RENAME oldfilereference t netifilereference[mTEMP] 



PARAMETERS 

oldfilereference 



netifi I ereference 



TEMP 



Current name of file, written in the following format: 

filename [/lockword] [.groupname[.acctname] ] 

If acctname is specified, it must be that of your logon account. You must be 
the creator of the file to rename it. 

New name of file, in the same format as oldfilereference. If acctname is 
specified, it must be that of your logon account. If groupname is specified, 
it must be one to which you have SAVE access. If acctname and/or group - 
name are omitted, the logon account and/or group are assumed. 

Indicates that the old file was, and the new file will be, temporary files. 
The default is that a permanent file is assumed. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The : RENAME command changes the system file identification for a permanent or temporary disc file. It 
can be used to change the name of a file, to move a file from one group to another (by specifying a dif- 
ferent groupname in the newfilereference parameter), or to change the lockword. You cannot rename 
files that exist in other accounts. (To transfer a file from one account to another, use : FCOPY. ) 

To rename a file, its group's volume set must be physically mounted or the command will fail. Also, you 
cannot rename a file across volume sets. 

To rename a file, you must be the file's creator and have exclusive (which implies LOCK) access to the 
file. 
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EXAMPLES 

Since temporary files exist only for the duration of your current job or session, their fully qualified 
filenames correspond to your logon group and account. To change the name of a temporary file from 
OLDFILE to NEWFI LE, and reassign it to the group NEWG, enter: 

: RENAME OLDFILE.NEWFILE.NEWO.TEMP 

Temporary files are valid 'only in your logon group, and are stored according to their fully qualified 
filenames. 

To change the lockword of the permanent file FILE2 from LOCKA to LOCKS, enter: 

t RENAME FILE2/L0CKA.FILE2/L0CKB 

To transfer a file from one group to another within the same account, use the : RENAME command, simply 
naming the new group in the second parameter. (You must be the creator of the file to use this com- 
mand.) To move the file MYFILE from GROUP 1 to GR0UP2, for example, you would enter: 

: RENAME MYFILE.0R0UP1 ,MVFILE.GR0UP2 

To use : RENAME in this way, you must have SAVE access to the group named in the second parameter 
(GR0UP2 in the previous example). In addition, both groups must be in the system domain or must both 
reside on the same volume set. 

ADDITIONAL DISCUSSION 

MPE File System Reference Manual (30000-90236) 
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:REPLY/=REPLY 



Replies to pending resource requests at the Console. 

SYNTAX 



PARAMETERS 

Pi" The Process Identification Number of the message sender. As part of the message 

requesting the REPLY, the pin always appears after the second slash mark ("/"). In 
the following example, the pin is 43 . 

?16:15/#S25/43/LDEV# FOR "T" ON TAPE (NUM)? 

reply The reply type specified in parentheses in the message, defined by one of the 

following: 

(NUM) Reply must be a logical device number. 

( Y/N ) Reply must be YES (or Y ), or NO (or N ). 

(MAX CHARS . =nn) Reply must be a string expression consisting of 

nn characters or less. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
issued only from the Console. * 

* : REPLY may be distributed to specific users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

User programs that have requested the use of a device and are waiting for your :REPLY/=REPLY remain 
suspended indefinitely, and cannot be aborted until the : REPLY is issued. If for any reason you cannot 
reply as requested, such as the particular device is nonexistent or a special form is unavailable, then 
:REPLY/=REPLY with "0" if type NUM is requested, and with "N" if type Y/N is requested. This returns an 
error code to the program and the : REPLY/=REPLY is aborted. 

The reply will usually take the form "(NUM)" or "(Y/N)", since "(MAX CHARS. =nn)" is used only for 
labeled tapes. 

If your reply is not of the type specified, if the pin is incorrect, or if the device you allocate is already al- 
located to someone else, the system displays the following error message: 

NO REPLY OUTSTANDING FOR PROCESS 
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EXAMPLES 

To reply to a message from the MPE system, enter: 

10:05/#J19/15/LDEV# FOR "NAS" OF TAPE1600 (NUM)? 
z REPLY 15,7 

or 

= REPLY 15,7 

To reply to a FORMS message from the MPE system, enter: 

15:46/#S93/22/F0RMS: PLEASE MOUNT MAILING LABEL FORMS 
?15:46/#S39/22/SP#12/LDEV# FOR #S93;OUTFILE ON LP (NUM)? 

; REPLY 22,12 

1 5 : 46/#S39/22/LDEV# 1 2 FORMS ALIGNED OK (Y/N)? ** Answering NO (N) to this ** 

** question causes the printing ** 

** to be deferred to a much ** 

** lower priority. After the ** 

** forms have been properly ** 

** aligned, use the :ALTSPOOL- ** 

** FILE to change the ** 

** spooling priority, in order ** 

** to send the spoolf ile to the ** 

** printer. ** 



: REPLY 22, NO 

?15:48/#S93/22/LDEV#12 FORMS ALIGNED OK (Y/N)? ** Answering YES (Y) to this ** 

** question causes the spoolf ile ** 

** to go to the printer ** 

** in its assigned sequence. ** 



: REPLY 22, Y 

When the next spoolf ile becomes ACTIVE, you will be requested to mount the appropriate special or stan- 
dard forms. 

To reply to a standard forms request, enter: 

16:00/#S93/22/STANDARD FORMS 
?16:00/#S93/22/LDEV # FOR #S95;L ON LP (NUM)? 

:REPLY 22,12 
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REPORT 



Displays accounting information for the logon account and group. 

SYNTAX 



; REPORT [groupset] [§listfile] [|VS=yoZset] 



PARAMETERS 

groupset 



Specifies the accounts and groups for which information is to be listed. The 
permissible entries, some of which use "wildcard" characters, and their 
capability requirements (Account Manager, AM, and/or System Manager, 
SM), are listed below. 



group 



e 



group. aoct 
%.acct 

6.6 

group. 6 



Reports on the specified group in the logon ac- 
count. This is the default for standard users, who 
may specify only their logon group. 

Reports on all groups in the logon account. This 
is the default for Account Managers, but may be 
executed by users with AM or SM capability. 

Reports on the specified group in the specified 
account. This requires SM capability. 

Reports on all groups in the specified account. 
This requires AM capability (if it is the logon ac- 
count) or SM capability for any account. 

Reports on all groups in all accounts. This is the 
default for System Managers and requires SM 
capability. 

Reports on specified group in any account. This 
requires SM capability. 



The characters 6 , # , and ? can be used as wildcard characters, but will count toward the eight-character 
limit. These wildcard characters have the following meanings. 



6 



Specifies zero or more alphanumeric characters and 
denotes all members of the set. 

Specifies one numeric character. 

Specifies one alphanumeric character. 
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The characters can be used as follows. 

n@ Report on all groups starting with the character "n". 

§n Report on all groups ending with the character "n". 

n@x Report on all groups starting with the character "n" and 

ending with the character "x". 

n##. . .# Report on all groups starting with the character "n" fol- 

lowed by up to seven digits. 

?n@ Report on all groups whose second character is "n". 

n? Report on all two-character groups starting with the 

character "n". 

?n Report on all two -character groups ending with the 

character "n". 

These characters, when placed appropriately in the groupset parameter, 
may also be used to report on accounts. 

list file Actual file designator of the output file to which information is to be writ- 

ten. The default is $STDLI ST, but output may be redirected with a : FILE 
equation as follows: 

: FILE LIST1,DEV=LP 
: REPORT, »LIST1 

Oolset Informs MPE to report accounting information for the specified volume 

set. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is Breakable (aborts execu- 
tion). The user must have Account Manager (AM) or System Manager (SM) capability to execute this 
command. 

OPERATION 

The : REPORT command displays the total resource usage logged against accounts and groups, and the 
limits on those resources. For the standard user, data will be displayed for his or her own group only; an 
Account Manager may specify all groups in his or her account; the System Manager may specify any or all 
groups in any or all accounts. 

The information includes usage counts and limits for permanent file space (in sectors), CPU time (in 
seconds), and session connect time (in minutes). The file space usage count reflects the number of sectors 
used at the time the : REPORT command is issued. However, CPU time and connect time usage appear as 
they were immediately before the beginning of the current job. 
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EXAMPLE 

To obtain accounting information for your group, enter the : REPORT command. Accounting information 
will be displayed similarly to the REPORT of the SOPRM account shown below: 

: REPORT @. SOPRM 



ACCOUNT 


FILESPACE- 


-SECTORS 


CPU- 


SECONDS 


CONNECT- 


-MINUTES 


/GROUP 


COUNT 


LIMIT 


COUNT 


LIMIT 


COUNT 


LIMIT 


SOPRM 


99004 


** 


99057 


** 


88407 


** 


/GLOSSARY 


1068 


** 


542 


** 


656 


** 


/PUB 


182 


** 


123 


#* 


1155 


Wft 


/SECT1 


180 


»« 


85 


** 


429 


*« 


/SECT 10 


11779 


** 


25271 


«« 


9716 


** 


/SECT2 


390 


»# 


4123 


#* 


5302 


** 


/SECT3 


10675 


«« 


8176 


#* 


13116 


** 


/SECT4 


2372 


ft* 


225 


#* 


294 


** 


/SECT5 


46579 


ft* 


27218 


»* 


25744 


*« 


/SECT6 


6008 


** 


9324 


** 


6638 


** 


/SECT7 


4748 


** 


8303 


*« 


13263 


** 


/SECT8 


1957 


»* 


6348 


#* 


3997 


** 


/SECT9 


3195 


** 


4570 


ft* 


4213 


*« 
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:RESET 



Cancels file equations. 



SYNTAX 



RESET 



{formaldesignaior) 



«? 



> 



PARAMETERS 

formaldesignaior 



e 



A formal file designator name in the form 

file[.group[.account]] [.nodespec], for which a :FILE command has 
previously been issued. The nodespec portion may be an environment iden- 
tifier indicating the location of the file, or it may be $BACK. Specifying 
$ BACK means that the file resides one "hop" back toward your local system 
(which may be the local system itself). 



Signifies all formal file designators specified in all 
previously issued in this session or job. 



:FILE commands 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The : RESET command resets a formal file designator to its original meaning, cancelling any 
command that has been issued for this formal file designator earlier in the current session or job. 



:FILE 



NOTE 



The nodespec parameter is not part of the HP 3000 
Fundamental Operating System. The NS/3000 AdvanceNet 
subsystem must be purchased separately. The nodespec pa- 
rameter is optional: if you do not have NS/3000 
AdvanceNet, omitting the nodespec parameter will make no 
difference in the performance of the : RESET command. 

However, specifying nodespec on a system that does not have 
NS/3000 will produce an error. 
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EXAMPLE 

To cancel the effects of a previous : FILE command that specified characteristics for a file programmati- 
cally referred to as ALPHA enter: 

; RESET ALPHA 

ADDITIONAL DISCUSSION 

Refer to the :FILE command in this section. 
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:RESETACCT 



Zeroes the running counts of CPU time or connect time accumulated by an account and by all groups 
within that account. 

SYNTAX 



; RESET ACCT [ 



[ 6 ] «[CPU ].. 

[acct ] L; * [CONNECT] J J 



PARAMETERS 



acct 



CPU 



CONNECT 



Specifies that the counters for all accounts, and all groups within the ac- 
counts, are to be reset. Default. 

Specifies the name of a particular account, and all groups within the ac- 
count, for which the CPU and connect time are to be reset. Default is §. 

Specifies that only the CPU usage counter is to be reset. Default is that 
both the CPU and connect time counters are reset. 

Specifies that only the connect time usage counter is to be reset. Default is 
that both the CPU and connect time counters are reset. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. A user 
must have System Manager (SM) capability to execute this command. 

OPERATION 

This command zeroes the running counts of CPU or connect time accumulated by an account and by all 
groups within that account. If all parameters are omitted when you execute : RESET ACCT, all counters 
(except file space) for all groups in all accounts are reset. 



EXAMPLE 

To reset the CPU counter for all accounts in the system, enter: 
:RESETACCT @,CPU 
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:RESETDUMP 



Disables the Stackdump facility. 

SYNTAX 



:RESETDUMP 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. 

OPERATION 

The : RESETDUMP command disables the MPE Stackdump facility (enabled by :SETDUMP command). 
Refer to the MPE Debug/Stack Dump Reference Manual (30000-90012). When entered in BREAK, 
:RESETDUMP does not modify the state of processes already created. If the Stackdump facility is not 
enabled, the : RESETDUMP command has no effect. 

EXAMPLE 

To disable the Stackdump facility, enter: 
: RESETDUMP 

ADDITIONAL DISCUSSION 

MPE Debug/Stack Dump Reference Manual (30000-90012) 
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:RESTORE 



Returns files that have been stored on magnetic tape or serial disc to the system. 

SYNTAX 



:RESTORE [restoref ile] fe </""*Jf * [ '!^f set] l ./««»< !-/«•««] ][ , . . . J > 

{*. indirect file ) ' 

[iDEV=dei)ice] 

[;SHOW= [showparm[ *showparm[ ,...]]]] 

[|FI lES=max files] 

{LOCAL } 

[|{{GROUP=# roupname }[;•••])] 
{ACC[oun]T=acctname} 

(GROUP } 
[ ^CREATE [ = {ACCT >[,...]]} 
{CREATOR} 

[i;CREATOR [=username] ] 

fi {KEEP >. 
u {NOKEEP} J 

ri {OLDDATE}, 
li {NEWDATE} J 

[10NERR[or] = <^>] 

[REST0RESET= tapel istspec] 

[pTARTHERE] 

[|C0PYACDJ 



PARAMETERS 

restorefile The name of the input device on which the files to be restored exist. If the 

you have previously referenced the device with a :FILE command, you can 
backreference it with an asterisk (*). Release E/F. 00.00 requires this 
parameter. If you do not specify an input device, : RESTORE uses the logon 
user name and the default device, TAPE. To use multiple input devices, use 
the RESTORESET parameter. 
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fileset Specifies the set or sets of files to be restored. This parameter has the form: 

filename [.groupname [.acctname]] 

You can use the characters g, #, and ? as wildcard characters to refer to a 
group of files. The wildcard characters count toward the eight character 
limit for the user, group, account, and file names. The wildcard characters 
have the following meanings: 

g Represents zero or more alphanumeric characters. Used 

alone, g denotes "all members of the set" 

# Represents one number 

? Represents one alphanumeric character 

You might use the wildcard characters as shown in the following examples: 

n@ Stores all items beginning with the character "n" 

gn Stores all items ending with the character "n" 

ngx Stores all items starting with the character "n" and 

ending with the character "x" 

n####### Stores all items starting with the character "n" followed 

by seven digits 

?ng Stores all items whose second character is "n" 

n? Stores all two-character items beginning with an "n" 

?n Stores all two-character items ending with an "n" 

If you do not specify an account or group, MPE assumes the logon account 
or group. The fileset default for standard users is g which restores all files 
in the logon group. 

You can use more than one fileset (and an associated - fileset) with a single 
: RESTORE command. The maximum number of file sets is limited to all 
files in up to 10 different accounts, all files belonging to 15 different 
groups within the same account, or 20 different files within the same group 
and account. 

-fileset Name of a file set or subset to be excluded. You can have only one 

(G. 00. 00) and later excluded subset for each file set, and you cannot include excluded file sets 

within other excluded file sets. A negative sign (-) must precede this 

parameter. 
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I 



! indirect file 
(G. 00. 00) and later 



device 



An ASCII file that contains the parameters for a : RESTORE command. 
Each line of the indirect file may contain file sets and keywords. Use an 
indirect file when you need to restore the same set of files regularly or 
when your : RESTORE command exceeds the Command Interpreter 
26 8 -character limit. An exclamation point (!) must precede this 
parameter. 

Device class (devclass) or logical device number (Idev) of the device on 
which the file is to reside. If you specify a device class (a type of device), 
RESTORE allocates the file to any of the volumes of the volume set within 
that class. A logical device number designates a specific device. When you 
specify a logical device number, RESTORE allocates the file to that device 
only if one of the volumes in the volume set currently occupies that device. 

By default, RESTORE attempts to restore a file on the same device class as 
specified in the file's label. If it cannot, RESTORE tries to restore the file 
on a logical device compatible with the type and subtype specified in the 
file label. If the second attempt fails, RESTORE tries to restore the file to 
the device class "DISC." If all three attempts fail, MPE does not restore the 
file. 



SHOW 



Requests a listing of restored files. By default, RESTORE lists the total 
number of files restored and not restored, and the reason a file was not 
restored. Unless you use a :FILE command to redirect the listing, 
RESTORE sends it to $STDLIST (formal file designator $SYSLIST) . 



showparm 

(G. 00. 00 and later) 



May be SHORT, LONG, DATES, SECURITY, or OFFLINE. You cannot use both 
SHORT and LONG, but you can combine all other options, separating them 
with commas. If you select neither SHORT nor LONG, RESTORE uses SHORT 
if $STDLIST is less than 99 characters and LONG otherwise. 



SHORT 



LONG 



Displays the file name, group name, account name, 
logical device number, sector address, reel number, and 
file size (in sectors) of all files stored. 

Displays the same information as SHORT and the file 
record size, file type, end -of -file, file record limit, 
blocking factor, extents allocated, and maximum extents 
of all files stored. 



DATES 



Displays the creation date, last access date, and last 
modification date of all files stored. 



SECURITY Displays the creator and file access matrix of all files 

stored. 



OFFLINE 



Sends file listings to the system line printer as well as to 
your terminal. You can redirect the output from the 
system line printer to another output device with a 
:FILE command redefining the formal file designator 
OFFLINE. 



OCT 1988 



2-282 



LOCAL, 

groupname, or 
ace t name 
(G. 00. 00 and later) 



CREATE= 

GROUP, ACCOUNT, or 

CREATOR 

(G. 00. 00 and later) 



CREATOR=usemame 
(G. 00. 00) and later 



KEEP(E/F.00.00 

and G. 00. 00 and later) 

and NOKEEP 

(G. 00. 00 and later). 



Restores files from different systems or directory structures. LOCAL 
restores all files to the user's creator identification, group, and account. To 
restore a file with the LOCAL option, you must have READ access to the 
tape file. Check your capabilities against the account, group, and file 
securities of the tape file. You must have SM or OP capability to restore a 
file with the LOCAL option from a nonexistent account or across an existing 
account. You need AM, OP, or SM capability to restore a file from a 
nonexistent group of your logon account. Specifying a groupnatne changes 
file group names to the name you specify. Specifying a accountname 
changes file account names to the name you specify. 

Builds groups, accounts, and creators that do not currently exist in the 
directory. When it creates a group, account, or creator, : RESTORE sends a 
message to $SYSLIST (default $STDLIST). GROUP creates the group 
specified in a file's file label and requires System Manager (SM) or Account 
Manager (AM) capability. ACCOUNT (or its short form ACCT) creates the 
account specified in the file label and requires SM capability. CREATOR 
creates the creator described in the file label and requires AM capability. 
By default, : RESTORE creates directory components based upon your 
capabilities. 

Changes all files' creator identifications to username. If username does not 
exist in the directory, the file is not restored unless CREATE is specified. 

Do not use the equal sign if username is unspecified. If you do not specify 
CREATOR=userfiome, : RESTORE uses the creator named in the file label 
when that creator exists in the directory. If the creator does not exist, it 
does not restore the file unless CREATE is specified. . 

You use these two parameters to control whether or not : RESTORE replaces 
files that already exist on disc. KEEP instructs : RESTORE to keep disc files, 
and not to restore tape files that duplicate them. NOKEEP purges files from 
disc and restores the tape file (if : RESTORE cannot restore the tape file, it 
keeps the disc file). The default is NOKEEP in G. 00. 00 and later releases. 



NEWDATE MPE stores four dates in each file's label: the creation date, modification 

(MPE G. 00. 00 and later) date, last access date, and the allocation date and time. NEWDATE changes 

or OLDDATE all dates and times to the date and time that you restored files. OLDDATE 

(MPE E/F. 00. 00 and retains the original modification and last access date, but changes the 

MPE G. 00. 00 and later) creation and allocation dates to the date and time you restored the files. 



QUIT or 
SKIP 



Directs : RESTORE to quit or continue when it encounters a tape error. 
When you specify SKIP, : RESTORE skips to the next file after the tape 
error and begins reading files from the tape. It does not restore the files 
that it was unable to read. When you use QUIT, : RESTORE terminates upon 
encountering a tape error. The default and only option for labeled tapes is 
QUIT. The default for unlabeled tapes is SKI P. 



STARTHERE 



:RESTORE normally requires mounting of the first tape volume containing 
any of the requested files. If some tape containing needed files is not 
available, you can mount the first available tape and specify ;STARTHERE as 
an option in your RESTORE command. This causes requested files on prior 
volumes to be listed but not restored. Restoration begins with the first 
qualifying file on the mounted tape. 
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RESTORESET Specifies input from multiple devices. All devices must have the same 

(G. 03. 00 and later) device type, device subtype, density, and record size. You can only use 

RESTORESET if you purchase TurboSTORE. 



NOTE 



In release G.03. 00 and later versions of MPE V/E, there 
are two versions of STORE and RESTORE: standard 
STORE/RESTORE and TurboSTORE. Standard 

STORE/RESTORE is part of the Fundamental 
Operating System (FOS). TurboSTORE is a separate 
product. When installed on your system, TurboSTORE 
adds additional capabilities to the : STORE and 
: RESTORE commands. This manual describes both 
versions of STORE and RESTORE. 

tapelistspec Describes input devices for the RESTORESET parameter. It has the 

(G. 03. 00 and later) following syntax: 

{tapedeoice) [ , tapedeoice] [...][, tapedeoice] 

tapedeoice Specifies an output device. Must backreference a : FILE 

command. 

COPYACD Specifies that Access Control Definition (ACD) are to be copied. If the 

COPY AC D option is specified, any ACDs associated with the file are restored 
with the file. If no ACDs are stored with the file, the file is restored and 
an asterisk is printed after the filename. The default is that ACDs 
associated with a file are not copied. 

If wild cards are used to define file names, the system tries to restore each 
file with its associated ACD. If an ACD associated with a file fails to 
restore, an appropriate message is displayed and procedssing continues. If 
an ACD exists on a file and COPYACD is not specified, then the file is 
restored without the ACD. 



USE 

You can issue a : RESTORE command from a Session, Job, Program, or in BREAK. It is Breakable (suspends 
execution). You must have System Manager (SM), System Supervisor (OP), or Privileged Mode (PM) 
capability to restore privileged f iles. 



OPERATION 

RESTORE transfers files stored on tape with the STORE or SYSDUMP program to disc. 

Release G.03. 00 and subsequent releases of MPE support an enhanced version of RESTORE that lets you 
copy files from multiple devices. 
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Before entering a : RESTORE command, identify the devices fr->m which you intend to restore files with a 
:FILE command. Backreference the devices in the : RESTORE command. RESTORE sends messages to 
the System Console requesting the System Operator to mount the tape or serial disc device to allocate the 
device. 

RESTORE sends the output it generates to a file whose formal designator is $SYSLIST. If RESTORE 
encounters a directory error while updating the directory, updating the Disc Free Space tables, or writing 
the data to the disc file, it reports the error to $SYSLIST (defaults to $STDLIST) and continues. 
RESTORE does not restore any file belonging to a group whose home volume set has not been mounted. 

The : RESTORE (G.00.00 or later) command resides in a program file (STORE. PUB. SYS), rather than a set 
of procedures with no global memory. Both the : STORE and RESTORE commands initiate this program. 
Use : ALLOCATE STORE. PUB. SYS to speed up the loading process and reduce the use of system resources. 
If you are restoring from a large tape or disc, such as a SYSDUMP tape, you must include the maxfiles 
parameter or the file(s) will not be restored. The value of maxfiles should be a least as large as the 
maximum number of files on the device from which you are restoring. 

If you do not specify a restorefile (G.00.00 or later), then RESTORE uses a default tape name. The 
default tape name is equal to your logon identification and the device is "TAPE". For example, if you are 
logged on as TOM.MGR, then the tape request will be for "TOM". You cannot use a file equation to change 
this default. Your capabilities determine which files you can restore. If you have System Manager or 
System Supervisor capability, you can restore any file, assuming the account and group to which the file 
belongs, and the user who created the file, are defined in the system. If you have Account Manager 
capability, you can restore any file in your account. To restore files with negative file codes, you need 
Privileged' Mode capability. If you have standard user capability, you can restore files in your logon 
account. 

MPE G. 00. 00 and later releases allow you to build groups, accounts, and creators that do not currently 
exist in the directory. This way, you can restore files to your system without first defining the account, 
group, and user with the :NEWACCT, :NEWGROUP, and :NEWUSER commands. 

The System Manager and System Supervisor can restore lockword-protected files without specifying the 
lockword. 

Users without SM or OP capability must always supply the lockword. You can issue the : RESTORE 
command with the :RUN STORE. PUB. SYS command. Use the "INFO=" parameter to specify the restore 
options, file sets, and keywords; in this case, the : RESTORE command executes with no further 
interaction. If you do not include the "INFO=" parameter, the "<--" prompt appears. Acceptable 
responses are: a complete : STORE command, a complete : RESTORE command, an MPE command preceded 
by a colon (:), or EXIT. 

When you use the :RUN command, the system defined JCW "CIERROR" does not change even if 
RESTORE aborts. When you issue a : RESTORE command from the Command Interpreter (For example, 
: RESTORE *T;€) the system defined JCW "CIERROR" changes to the value 1091 if the : RESTORE 
command aborts for any reason. Check this value after : RESTORE aborts with the : SHOWJCW command. 



NOTE 



The G.01.00 and later releases of RESTORE determine 
whether sufficient disc space remains to restore a file that 
already exists on the disc. If sufficient space remains, 
RESTORE writes a new copy of the file to the disc before 
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purging the old copy of the file. RESTORE purges the old 
copy of the file only if the RESTORE operation is successful. 

If sufficient space is not available, .-RESTORE first purges 
the old copy of the file and then writes a new copy to the 
disc. If the : RESTORE operation fails in this circumstance, 
you receive a message on $STDLIST informing you that 
there is no copy of the file on the disc: 

"***WARNING: OLD FILE HAS BEEN PURGED***" 



EXAMPLES 

To restore all files belonging to your logon group from the restorefile named "T 1 , enter: 

: FILE T;DEV=TAPE 
i RESTORE *T;g;KEEP;SHOW 

In response, the System Operator receives a request to mount the tape identified as "T". If a disc file on T 
already exists in the system, it will not be restored because the KEEP parameter was specified. To restore a 
file ABC without specifying a restorejile (G. 00. 00 or later), you do not need to use a file equation. For 
example: 

: RESTORE; ABC. PUB. SYS; SHOW 

STORE/RESTORE, VERSION 2 (C) 1981 HEWLETT-PACKARD CO. 

FRI, APR 12, 1985, 11:56 AM 

WILL RESTORE 1 FILES; NUMBER OF FILES ON TAPE = 87 

FILENAME. GROUP .ACCOUNT LDN ADDRESS REEL SECTORS CODE 

ABC .PUB .SYS 2JJ00100217 2 4 

FILES RESTORED: 1 

FILE NOT RESTORED: 

When you restore files without specifying a fileset (G. 00. 00 or later), you see a warning message telling 
you that all files, based on your capabilities, will be restored: 

•.RESTORE 

STORE/RESTORE, VERSION 2 (C) 1981 HEWLETT-PACKARD CO. 

FRI, APR 12, 1985, 11:39 AM 

RESTORE 

#***WARNING: AN 'EMPTY' FILESET WAS FOUND. .. BASED ON YOUR 
CAPABILITIES, '%.%.%' WILL BE ASSUMED**** (S/R 6229) 
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To have the list of restored files printed on a line printer, enter. 

: FILE SYSLIST;DEV=LP 
: FILE T;PEV=TAPE 
: RESTORE «T;@;SHOW 

To restore the file "FILEA.GROUPA.ACCOUNTA" when the creator, USERA, does not exist on the system use 
one of the methods shown below: 

: RESTORE «TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATOR=USERB 
(Changes the creator of FILEA to USERB. USERB must exist on the system.) 



Or: 



: RESTORE «TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATE=CREATOR 
(Creates USERA on the system.) 



Or: 



; RESTORE »TAPEFILE; FILEA.GROUPA.ACCOUNTA; CREATE 
(Creates USERA on the system.) 

To restore only a subset of the fileset (G. 00. 00 or later), enter: 

' RESTORE »T; 6.@.g -g. PUB. SYS ** Restore all files except those in the PUB group of the 

SYS account. ** 

To restore using the : RUN command, enter: 

: RUN STORE. PUB. SYS; INFO="RESTORE »T;e.e.e;SHOW" 

To restore files from two sequential devices, issue two :FILE commands to name the devices. Then use 
those file names in your : RESTORE command as shown below: 

: FILE TAPE1;DEV=TAPE 
: FILE TAPE2;DEV=TAPE 
; RESTORE €.6.6; RESTORESET= (TAPE 1 » TAPE2 ) 

ADDITIONAL DISCUSSION 

MPE V Storing and Restoring Files (32033-90133) 
MPE V System Backup and Recovery (32033-90 1 34) 
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:RESUME 



Resumes execution of a suspended operation. 

SYNTAX 



: RESUME 



PARAMETERS 

None. 

USE 

This command may be issued only while in BREAK. It may not be used from a Session (other than while 
in BREAK mode), Job, or Program. It is not Breakable. 

OPERATION 

After a program or MPE command operation is suspended by pressing (BREAK) or by using the 
-CAUSE BREAK intrinsic, the : RESUME command resumes execution of the operation at the point where the 
execution was suspended. Note that the : RESUME command is legitimate only during a BREAK. Many 
MPE commands are aborted rather than suspended by a BREAK, and thus cannot be resumed. (Refer to 
Table 1 - 1 for a list of nonbreakable commands. ) 

If instead of : RESUME, you enter another program command (such as : EDITOR, : FORTRAN or :RUN) or one 
of the nonprogram commands (: HELLO, :BYE, :JOB, or :DATA), the Command Interpreter prints the 
following message on your terminal: "ABORT? (YES/NO)" If you respond "YES" to the "ABORT?" message, 
the Command Interpreter aborts the current program and executes the command. 

If you respond "NO" to the "ABORT?" message, the Command Interpreter prints the message "COMMAND NOT 
ALLOWED IN BREAK" and prompts you for another command. If you now enter RESUME at a colon (:) 
prompt, the suspended program continues at the point where it was interrupted. If you had logged on 
using : ( ) COMMAND LOGON with a program command inside the parentheses, then responding "YES" to 
the "ABORT?" message causes MPE to abort the command and to log you off immediately. 

EXAMPLE 

To continue a suspended program at the point of interruption, enter 

; RESUME 
R EAD PE NDING 
(RETURN] 
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:RESUMEJOB 



Resumes a suspended job. 

SYNTAX 



:RESUMEJOB #\nnn 



PARAMETERS 

§Jnnn 



A job number. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only from the Console. * 

* Unless distributed with the :ALLOW command, or if the : JOBSECURITY is set LOW. 

OPERATION 

The System Operator uses the : RESUMEJOB command to direct MPE to resume processing a job suspended 
with the : BREAKJOB command. The job will continue execution from the point at which it was 
suspended; no message is issued. 



EXAMPLE 

To resume the processing of job 68 , enter: 
: RESUMEJOB #J68 
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:RESUMELOG 



Resumes system logging following suspension caused by an error. 

SYNTAX 



: RESUME LOG 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, Program, or in BREAK. It may be executed only from 
the Console or by a user with System Supervisor (OP) capability unless distributed to users with the 
: ALLOW command. 

OPERATION 

There are two types of system logging errors; recoverable errors and irrecoverable errors. The type of 
error is identified by the error number. 

If a recoverable error occurs, : RESUME LOG needs to be invoked after the error is corrected and the system 
configured to allow other users to log back on to the system. 

If an irrecoverable error occurs (catastrophic error which is either a physical input/output error or unit 
failure); :RESUMELOG can not resume the logging facility. The system needs to be shutdown and then 
restarted. 

When the Operator directs MPE to resume logging with :RESUMELOG, a special Log Record is displayed 
that denotes the number of log events and corresponding records that were not recorded while logging was 
suspended; the total number of unrecorded job initiation records; and the total number of unrecorded 
job/session termination records. 

EXAMPLES 

Assume the system is online and running with logging enabled. If a recoverable error occurs, the 
following error message is sent to the System Console: 

ST/10: 43/LOG FILE NUMBER 104 ERROR #46. LOGGING SUSPENDED 

After the error is corrected, enter the : RESUME LOG command. A confirmation message will then appear 
at the System Console, as follows: 

ST/10: 45/LOGFILE NUMBER 104. LOGGING RESUMED. 
ST/10:45/LOG FILE NUMBER 104 ON. 
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ADDITIONAL DISCUSSION 

Refer to the discussion of system logging in "MPE LOGGING FACILITIES" in the MPE V System 
Operation and Resource Reference Manual (32033-90005). 
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:RESUMESPOOL 

Resumes suspended spooler output to a spooled device. 

SYNTAX 



:RESUMESPOOL JcfetffBACK \"" n "J^f] 
s [nnn PAGES] 

:RESUMESPOOL ZcfeiiFORWARD \ nnn "^J 
' [nnn PAGES] 

:RESUMESPOOL ZcfeyJIfBEGINNING 



PARAMETERS 

Idet) 
BACK 

FORWARD 

BEGINNING 

nnn 



FILES or 
PAGES 



The logical device number of a spooled device. 

Instructs the spooler to backspace nnn files or nnn pages and resume print- 
ing at that point. (Refer to "OPERATION".) 

Instructs the spooler to space forward nnn files or nnn pages and resume 
printing at that point. (Refer to "OPERATION".) 

Instructs the spooler to resume printing at the beginning of the file which 
had been previously suspended. 

The number of files or pages you wish the spooler to backspace or space 
forward when printing resumes. (Must be an integer between 1 and 256, 
inclusive. ) 

Informs the spooler process which unit of measure to use when printing 
resumes. For the purposes of this command, FILE is defined as the text ap- 
pearing between FOPEN intrinsic statements within the spoolfile. (Refer to 
"OPERATION".) Note that the use of the FILES parameter is not allowed 
on the HP 2680A page printer or an HP 2608S CIPER -protocol printer. 
PAGE is the literal page (usually 60 lines or skip to channel 1), as output by 
the spooler to the printer. 



USE 

This command may be issued from a Session, Job, Program, or in BREAK. It is not Breakable. It may be 
executed only at the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 
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OPERATION 

If you specify only the Idev parameter, the printer will resume printing at the beginning of the highest 
priority spoolfile. Otherwise, the printer will resume printing the previously ACTIVE spoolfile. 

Always overestimate the number of files or pages you need when using the BACK parameter or underes- 
timate the number when using the FORWARD parameter. This is the only way to ensure that you get all 
the output you need, since partial pages and header pages affect the page count. However, if you instruct 
the spooler to go BACK further than the beginning of the file, MPE will display an error message on the 
System Console and printing will resume at the beginning of the file. Similarly, an error message is 
generated if you instruct the spooler to advance FORWARD beyond the point where files exist. In this case, 
printing will not resume until a new command is issued. 

By using the SPOOK utility with mode control on, you can determine where each FOPEN intrinsic occurs 
within a spoolfile. This is useful, for example, when you are compiling, preparing, and running large 
programs, and printing the entire output is unnecessary. For information about the SPOOK utility, refer 
to the MPE V System Utilities Reference Manual (32033-90008). 

EXAMPLES 

To resume output to logical device number 6 at the beginning of the file, enter: 

; RESUMESPOOL 6; BEGINNING 
To resume output to logical device number 6 , and reprint the last two pages, enter: 

r RESUMESPOOL 6; BACK 2 PAGES 
To resume output to logical device number 6, and print the highest priority spoolfile, enter: 

:RESUMESPOOL 6 
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:RPG 



Compiles an RPG program. RPG is not part of the HP 3000 Fundamental Operating Software and must 
be purchased separately. 



SYNTAX 




PARAMETERS 

textfile 

uslfile 



listfile 
masterfile 



neiofile 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is RPGTEXT. 
Default is $STDI N. 

Actual file designator of the User Subprogram Library (USL) file to which 
the object program is written. This can be any binary input file with a file 
code of USL or 1024. Its formal file designator is RPGUSL. If the uslfile 
parameter is omitted, the object code is saved to the temporary file 
$0LDPASS. If entered, this parameter refers to a file created in one of four 
ways: 

• By saving, with the MPE :SAVE command. Default is the USL file 
created during a previous compilation. 

• By building the USL with the MPE Segmenter-BUILDUSL command. 
(Refer to the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file with the MPE : BUILD command and 
specifying a file code of USLor already fixed in file 1024. 

• By specifying a nonexistent uslfile parameter, thereby creating a 
permanent file of the correct size and type. 

Actual file designator of the file on which the program listing is written. 
This can be any ASCII output file. Formal file designator is RPGLIST. 
Defaultis$STDLIST. 

Actual file designator of the master file to be merged against textfile to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is RPGMAST. Default is that the master file is not read, and in- 
put is read from textfile, or from $STDIN if textfile is not specified. If two 
files being merged have identical line numbers, the lines from textfile or 
from $STDIN will overwrite those in masterfile. 

Actual file designator of the file produced by merging textfile and the mas- 
terfile. This can be any ASCII output file. Formal file designator is 
RPGNEW. Default is that no file is written. 
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NOTE 

The formal file designators used in this command (RPGTEXT, 
RPGUSL, RPGLIST, RPGMAST, and RPGNEW) cannot be 
backreferenced as actual file designators in the command 
parameter list. For further information, refer to "Implicit 
:FILE Commands For Subsystems" discussion of the MPE 
:FILE command. 



USE 

This command may be issued from a Session or Job. It may not be issued in Break or from a Program. It 
is Breakable (suspends execution). 

OPERATION 

This command compiles an RPG program onto a User Subprogram Library (USL) file on disc. If you do 
not specify textfUe, MPE expects input from your standard input device. If you create the USL file before 
compiling the source code, you must assign it a file code of USL or 1 024. 

EXAMPLES 

The following example compiles an RPG program entered from your standard input device, storing the ob- 
ject code in the default USL file $OLDPASS. The listing is sent to the standard list device. 

: RPG 

The next example compiles an RPG program contained in the disc file SOURCE. The object code is stored 
in the USL file OBJECT, which is a permanent disc file created with the : BUILD command. The program 
listing is sent to the disc file LISTFL. 

: BUILD OBJECT ;C0DE=USL 
: RPG SOURCE .OBJECT, LISTFL 

To compile an RPG program, storing the object code in the USL file OBJECT (created during the compila- 
tion process) enter: 

; RPG SOURCE .OBJECT, LISTFL 

ADDITIONAL DISCUSSION 

RPG/3000 Compiler Reference Manual (32104-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:RPGGO 



Compiles, prepares, and executes an RPG program. RPG is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 



SYNTAX 




PARAMETERS 

text file 

list file 
masterfile 



new file 



Actual file designator of the input file from which source program is read. 
This can be any ASCII input file. Formal file designator is RPGTEXT. 
Default is $STDIN. 

Actual file designator of the file on which the program listing is written. 
This can be any ASCII output file. Formal file designator is RPGLIST. 
Default is $STDLIST. 

Actual file designator of a file which is merged against textfile to produce a 
composite source. This can be any ASCII input file. Formal file designator 
is R PGM AST. Default is that the master file is not read; input is read from 
textfile, or from $STDIN if textfile is not specified. If two files being merg- 
ed have identical line numbers, the lines from textfile or from STDIN will 
overwrite those in masterfile. 

Actual file designator for the file produced by merging textfile and the 
masterfile. This can be any ASCII output file. Formal file designator is 
RPGNEW. Default is that no file is written. 



NOTE 



The formal file designators used in this command ( RPGTEXT, 
RPGLIST, RPGMAST, and RPGNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information, refer to "Implicit :FILE Commands 
For Subsystems" section of the :FILE command. 



USE 

This command may be issued from a Session or a Job. It may not be issued in BREAK or from a Program. 
It is Breakable (suspends execution). 
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OPERATION 

This command compiles, prepares, and executes an RPG program. If you do not specify text file, MPE ex- 
pects you to enter the source code from your standard input device. 

The USL file created during compilation is a system defined temporary file $OLDPASS, which is passed 
directly to the Segmenter. It cannot be accessed, since the Segmenter also uses $OLDPASS to store the 
prepared program segments and overwrites the USL file of the same name. 

EXAMPLES 

To compile, prepare, and execute an RPG program entered from your standard input device, sending the 
program listing to your standard list device, enter: 

:RPGGO 

To compile, prepare, and execute an RPG program read from the disc file SOURCE, sending the program 
listing to the disc file LISTFL, enter: 

: RPGGO SOURCE ,LISTFL 

ADDITIONAL DISCUSSION 

RPG/3000 Compiler Reference Manual (32104-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:RPGPREP 



Compiles and prepares an RPG program. RPG is not part of the HP 3000 Fundamental Operating 
Software and must be purchased separately. 

Syntax 



iRPGPREP [textfile] Mprogfile] Mlistfile] \Mmsterfile] [§neti>file] ]]] 



PARAMETERS 

textfile 
prog file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. Formal file designator is RPGTEXT. 
Default is $STD IN. 

Actual file designator of the program to which the prepared program seg- 
ments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the Segmenter creates the program 
file, which will reside in the temporary file domain as $0LDPASS. If you do 
create your own program file, however, you must do so in one of two ways: 

• By using the MPE BUILD command, and specifying a file code of 1029 
or PROG, and a numextents value of 1. This file is then used by the 
: PREP command. 



listfile 



masterfile 



new file 



• By specifying a nonexistent file in the progfile parameter, in which 
case a job or session file of the correct size and type is created. Default 
is that $NEWPASS is assigned. 

Actual file designator of the file on which the program listing is written. 
This can be any ASCII output file. Formal file designator is RPGLIST. 
Default is $STDLIST. 

Actual file designator of the master file that is mergered against textfile to 
produce a composite sourcefile. This can be any ASCII input file. Formal 
file designator is R PGM AST. Default is that master file is not read; input is 
read from textfile, or from $STDI N if textfile is not specified. If two files 
being merged have identical line numbers, the lines from textfile or from 
$STDIN will overwrite those in masterfile. 

Actual file designator of the file produced by merging textfile and the mas- 
terfile. This can be ay ASCII output file. Formal file designator is 
RPGNEW. Default is that no file is written. 
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NOTE 



The formal file designators used in the command (RPGTEXT, 
RPGLIST, PRGMAST, and RPGNEW) cannot be backreferen- 
ced as actual file designators in the command parameter list. 
For further information, refer to "Implicit :FILE Commands 
For Subsystems" discussion of MPE :FILE command. 



USE 



This command may be issued from a Session or a Job. It may not be issued in BREAK or from a Program. 
It is Breakable (suspends execution). 

OPERATION 

This command compiles and prepares an RPG program to a program file on disc. If you do not specify 
textfile, MPE expects the source program to be entered from your standard input device. The USL file 
$OLDPASS, created during compilation, is a system -defined temporary file passed directly to the 
Segmenter. You can access it only if you do not use the $NEWPASS default for progfile. This is because 
the Segmenter also uses $OLDPASS to store the prepared program segments, overwriting any existing tem- 
porary files of that name. 

EXAMPLE 

The compile and prepare an RPG program entered from your standard input device, sending the listing to 
your standard list device, enter: 

:RPGPREP 

The USL file created during compilation is a temporary file passed directly to the Segmenter. You can 
access it under the name $0LDPASS only if the prepared program segments are not also stored in 
$OLDPASS (which will overwrite the USL file). Therefore, to save the compiled USL and the prepared 
program file, specify a non-existant file for progfile in the : RPGPREP command line and save the USL file 
$OLDPASS under another name. In the following example, the prepared program is saved as COMFL, and 
the USL file is renamed (and saved) to NUSL: 

; RPGPREP. COMFL 
; SAVE $OLDPASS,NUSL 

Unless you have specifically created a permanent file to store the prepared program, the program file 
COMFL will be stored in the temporary file domain. To save it as a permanent file, use the :SAVE 
command: 

:SAVE COMFL 
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Using the : BUILD command, you can create your own program file in the permanent file domain. When 
you do so, be sure to specify a file code of "PROG" or "1029" and a numextents parameter value of 1. 
Such a file is created in the next example. It is then used by the : PREP command. 

: BUILD PROGFL;CODE=PROG;DISC=,1 
: RPGPREP, PROGFL 

To send the program listing to a device other than the default standard list device, use the :FILE com- 
mand. In this example, the file equation assigns the filename LINEA to device class LP (your line printer). 
LINEA is then backreferenced in the : RPGPREP command line: 

: FILE LINEA;DEV=LP 

: RPGPREP, EDTDISC,COMFL,«LINEA 

ADDITIONAL DISCUSSION 

RPG/3000 Compiler Reference Manual (32104-90001) 
MPE Segmenter Reference Manual (30000-9001 1) 
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RUN 



Executes a prepared program. 



Syntax 



:RUN progfile\§entrypoint] 




[jpOPRIV] 
[|LMAP] 


<G} 
[|LIB={P>] 
{S} 


h DEBUG] 


[|NOCB] 


[ fMAX DATA= segsi ze ] 


\MlWFO=quotestring] 


[| PARM=parameternum] 
[|STACK=siac/csi2e] 


{*formaldesig} 
[!STDIN=[{/ii«r»/ }]] 
{$NULL } 


[§|DL=efZsize] 


{*formaldesig } 
[lSTDLIST=[{/tZere/[ i NEW]}]] 
<$NULL } 



PARAMETERS 

prog file 
entrypoint 



NOPRIV 



LMAP 



AUG 1986 



Actual file designator of the program file that contains the prepared 
program. 

Program entry point where execution is to begin. It contains a character 
string, terminated by a blank, specifying the entry point (label) in the 
program where execution is to begin when the program is executed. This 
point may be the primary entry point of program, or any secondary entry 
point in program's outer block. Default is primary entry point. 

Declaration that program segments will be placed in nonprivileged (user) 
mode. This parameter is for programs prepared with Privileged Mode 
capability and makes them accessible to nonprivileged users. Normally, 
programs containing privileged instructions are executed in Privileged Mode 
only if the program was prepared with Privileged Mode (PM) capability 
class. A program containing legally compiled privileged code, placed in 
nonprivileged mode, may abort when an attempt is made to execute it. If 
NOPRIV is specified in the :RUN command, all program segments are placed 
in nonprivileged mode. Library segments are not affected because their 
mode is determined independently. NOPRIV produces the same effect as 
omitting the $OPTION PRIVILEGED and OPTION PRIVILEGED entries in 
SPL source input. Default is that Privileged Mode programs will remain in 
Privileged Mode. 

Request to produce a descriptive listing of the allocated (loaded) program on 
the file whose formal file designator is LOADLIST. If there is no reference 
to LOADLIST in any :FILE command, listing is sent to $STDLIST. Default 
is no listing. 
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DEBUG 



segsize 



parameternum 
stacksize 

dlsize 



Request to issue a Debug call before the first executable instruction of the 
program. Unless you have READ and EXECUTE access to the program, 
this parameter is ignored. If assigned Privileged Mode (PM) capability, you 
are put in privileged mode Debug. If you do not have PM capability, you 
are put in user mode Debug. 

Maximum stack area (Z-DL) size permitted, in words. This parameter is 
included if it is expected that size of DL-DB or Z-DB areas will be changed 
during program execution. Regardless what you specify, MPE may change 
segsize to accommodate table overflow conditions. 

If you prepare your program with segsize less than the configured mini- 
mum, the value is rounded up to the minimum or to the amount needed by 
the program (as calculated by the Segmenter). The maximum actual segsize 
permitted a program is 32,767 words. If your specified segsize does exceed 
the maximum, it will be rounded down to 32,767 words. 

An integer containing a parameter to be passed to the new program (ac- 
cessed through Q-4 of the outer block). 

Size of initial local data area, Z-Q (initial), in the stack. This value, if 
specified, must be between 511 and 32,767 words. It overrides the 
default stack size estimated by MPE Segmenter. 

DL-DB area to be initially assigned to stack. This area is of interest mainly 
in programmatic applications. To accommodate system logging require- 
ments, the DL-DB area is always rounded upward in such a way that the 
distance from the beginning of the stack data segment to the DB address is 
a multiple of 128 words. This value must be within -1 and 32,767 words. 
The default is estimated by the MPE Segmenter. 



G, P, or S 



NOCB 



quotedstring 



Searches the segmented procedure libraries of the program file's group and 
account. The G option first searches the group library, then the account 
library, then the system library. The P option searches the account library, 
then the system library. The S option searches the system library for ex- 
ternal references to segmented procedures. Default is S. 

Request that file system not use the stack segment, PCBX, for its control 
blocks, even if sufficient space available. This permits expansion of the 
stack, by using the DLSIZE and ZSIZE intrinsics, to the maximum possible 
limit at a later time. However, NOCB causes the File Management System 
to operate more slowly. 

A sequence of ASCII characters bounded by a pair of single quotation 
marks (apostrophes) or by double quotation marks. If you want a quotation 
to appear within quotedstring, the quotation and its quotation marks must 
also be bounded by quotation marks. For example, to insert "and" into a 
quotedstring, it must appear as ""and"". Similarly, 'and' must appear as 
"and". The maximum length of the string, including delimiters, is 255 
characters. Refer to "EXAMPLES". 
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STDIN 



I 



STDLIST 



The string will be placed just after the global area of the new program's 
stack. A DB-relative byte pointer to the string in the new program's stack 
will be placed at Q-5 of the stack, where Q is the initial value of the 
Q -register at activation time. The length of the string in bytes will be 
placed at Q-6. If no string is specified, Q-5 and Q-6 will both contain 0. 
For more information refer to the CREATEPROCESS intrinsic in the MPE V 
Intrinsics Reference Manual (32033-90007). 

Use of this parameter allows the user to specify the file to be used as 
$STDIN by the program being executed. If this parameter is omitted, or if 
nothing is specified after the equal sign, as in ";STDIN=", then STDIN 
defaults to the standard input device for the job or session. STDIN files 
should be kept unnumbered. This parameter may use one of the following 
subparameters: 



*formaldesig 

fileref 
$NULL 



The formal file designator for a file previously specified 
in a file equation. 

The name of an existing permanent disc file. 

The actual file designator of a system defined file that is 
always treated as an empty file. When referenced by a 
program as $STDIN, the program receives only an end- 
of-file indication when accessed. When referenced by a 
program as $STDLIST, the associated write request is ac- 
cepted by MPE, but no physical output is actually per- 
formed. Thus, $NULL can be used to discard unneeded 
output from an executing program. 



Use of this parameter allows the user to specify the file to be used as 
$STDLIST by the program being executed. If this parameter is omitted, or 
if nothing is specified after the equal sign, as in ";STDLIST=", then 
STDLIST defaults to the standard list device for the job or session. This pa- 
rameter has the same subparameters as STDIN, but you may also specify the 
keyword NEW. 



NEW 



The name to be assigned to a job/session by fileref is a 
temporary disc file created with the system defaults. 
The system defaults of the new file are fixed length 
ASCII 132-byte records with a maximum file size of 
1 023 records. 



USE 

This command may be issued from a Session or a Job. It may not be issued in BREAK or from a program. 
It is Breakable (suspends operation). 

OPERATION 

This command executes a program prepared in a program file. It permits searching segmented libraries 
(SLs), to satisfy external references, Relocatable libraries (RLs) are not searched. 

If the volume set containing the file to be run is not mounted, this command implicitly causes that volume 
set to be mounted. 
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If the file is temporary, only the logon group and account libraries for the current session will be 
searched. Refer to MPE File System Reference Manual (30000-90236) for more information on file 
domains. 

EXAMPLES 

To list the segments of a loaded program, enter: 

; RUN XLAB;LMAP 
To run a program stored in the program file PR0G4, beginning at the entry point SECLAB, enter: 

: RUN PR0G4, SECLAB 

The following example runs a program "TESTPROG" with $STDIN set to an old disc file named INPUT and 
$STDLIST set to the line printer: 

; FILE LPFILE;DEV=LP 

: RUN TESTPROG; MAXDATA= 10000; STDIN=INPUT; STDLIST=«LPFILE 

The next example runs a program using the STDIN parameter, setting $STDIN to an existing disc file 
named INPUT, this time referenced through a file equation. In this example, $STDLIST is set to a 
temporary disc file named RESULTS that is automatically created by the : RUN command, enter: 

: FILE INFILE=INPUT,OLP 

; RUN TESTPROG;DEBUG;STDIN=«INFILE;STDLIST=RESULTS,NEW 

The following example of the :RUN command uses the "INF0=" parameter to pass a string to the program: 

; RUN MVPROG;MAXDATA=2000;INFO* "A test with ""and"" characters" 

In quotedstring, "and" is bounded by an extra pair of quotation marks. As a result, the string passed to the 
program is: 

A test with "and" characters 
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:SAVE 



Saves file in permanent system file domain. 



SYNTAX 



:SAVE 



{$OLDPASS*neu)filereference} 



{ tempfilereference 



} 



PARAMETERS 

$OLDPASS 

neiofi I e reference 



t empfi I ereference 



A system -defined temporary file. After this file is saved, it can no longer 
be referenced by the name $OLDPASS . 

New actual file designator assigned to $OLDPASS when it is made 
permanent. It format is: the format: 

filename [/lockmord] [.groupname[.acctname] ] 

If groupname is used, it must indicate a group to which you have SAVE 
access, as defined by your Account Manager. If groupname is omitted, the 
logon group is assigned. 

Actual file designator of the temporary file to be made a permanent file 
under the same designator. The file is deleted from the job/session 
temporary file domain and entered into the system file domain. Its format 
is: 

filename[/ lockaord] [.groupname[.acctname] ] 

If groupname is used, it must indicate a group to which you have SAVE 
access, as defined by your Account Manager. If groupname is omitted, the 
logon group is assigned. 



USE 

This command may be issued from a Session or a Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

The :SAVE command saves a temporary file by converting it to a permanent file in the system file 
domain. This command is necessary when the subsystem or program that created your file does not allow 
you to save it while the program is executing. The volume set for the group in which the file is to be 
saved must be mounted, because files cannot be saved across volume sets. 
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You must specify a new filename for $OLDPASS, because MPE does not allow $OLDPASS as a permanent 
filename. If, when saving $OLDPASS, there is a file in the temporary domain with the same name 
specified by newfilereference, MPE will attempt to save $OLDPASS by creating a new temporary file. This 
new temporary filename, created by : SAVE, will start with "S" and be followed by seven digits: Sdddhhmm, 
where ddd is the Julian day of the year, hh is the hour of the day, and mm is the minute. The new 
temporary file will then be saved under the filename specified by newfilereference, and be deleted from 
the temporary domain. If both temporary and permanent files exist under the same name specified by 
newfilereference, the temporary : SAVE file will be saved as a permanent file. In this case a printed error 
message will state the filename for the new :SAVE file (as in the above format Sdddhhmm). It can be 
renamed later using : RENAME. 

This command applies only to temporary files on disc. It is similar to opening a file with the FOPEN 
intrinsic, and then closing it with the FCLOSE intrinsic, using a permanent file disposition. 

EXAMPLES 

To save the temporary file $OLDPASS, containing an object program, to the program file PROGFILE, enter: 

: SAVE $OLDPASS , PROGF I LE 
To save the temporary file TEMPFL as a permanent file with the same name, enter: 

: SAVE TEMPFL 
To save the temporary file DATAFILE in the group GROUPX, enter: 

; SAVE DATAFILE.GROUPX 

To save a temporary file (other than $OLDPASS) and change its name, use the :SAVE and : RENAME 
commands. Only the logon group and account directories in the current session will be searched. For 
example: 

: SAVE DATAFILE 

: RENAME DATAFILE, DATABASE 
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:SECURE 

Restores security provisions for a file that were previously suspended by a : RELEASE command. 

SYNTAX 



: SECURE filereference 



PARAMETERS 

filereference Actual file designator of the disc file whose security provisions are to be 

restored. Its format is: format: 

filename [Mlochoord] [. g roupname[. ace t name]] 
USE 

This command may be issued from a Session or Job, in BREAK or from a program. It is Breakable. 

OPERATION 

The : SECURE command restores all security provisions for a file that were previously suspended by a 
: RELEASE command in this or another job. 

This command can be used only for a permanent disc file whose file label identifies the user as the creator 
of that file. The : SECURE command will fail if the group's home volume set is not mounted. When the 
normal (default) MPE security provisions are in effect, the file must belong to the logon account and 
group. 

EXAMPLE 

To restore the security provisions previously in effect for the file named FILE1, enter: 
:SECURE FILE1 
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rSEGMENTER 

Calls the MPE Segmenter. 

SYNTAX 



rSEGMENTER [listfile] 



PARAMETERS 

listfile Actual file designator of any ASCII output file that is to receive listed 

output from the MPE Segmenter. Formal file designator is SEGLIST. 
Default is $STDLIST. Usually this file is a line printer and must be defined 
in a : FILE command, backreferenced as follows: 

; FILE LISTFL;PEV=LP 
: SEGMENTER *LISTFL 



NOTE 



The formal file designator used in this command, SEGLIST, 
cannot be backreferenced as actual file designators in the 
command parameter list. For further information, refer to 
"Implicit :FILE Commands For Subsystems" discussion of the 
MPE :FILE command. 



USE 



This command may be issued from a Session or a Job. It may not be issued in BREAK or from a Program. 
It is Breakable (suspends execution). 

EXAMPLE 

To call the MPE Segmenter from a session and transmit the output to a line printer instead of the 
standard list device, enter: 

: FILE LISTFL;DEV=LP 
:SEGMENTER "LISTFL 



NOTE 



You must have READ and LOCK capability to use 
relocatable library with the Segmenter command. 
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ADDITIONAL DISCUSSION 

MPE Segmenter Reference Manual (30000-9001 1) 
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Allows a job using a spooled $STDLIST to mark its standard list device for deletion when the job 
terminates. 

SYNTAX 



•SET STDLIST= {DELETE> 
•SET 5TDLI5T- {SAVE y 



PARAMETERS 

DELETE Flags the job's $STDLIST for deletion at job termination. 

SAVE Cancels the effect of a previous :SET STDLIST=DELETE command. 

Default is SAVE. 

USE 

This command may be issued from a Job or a Program. It may not be issued from a Session or in BREAK. 
It is not Breakable. 

OPERATION 

The :SET command can be placed anywhere between the : JOB and : EOJ statements. It is most practical 
to place it at the end of a job stream since the command will not execute if the job fails. $STDLIST will 
then print, allowing you to study your listing, and locate the problem. The effect of a :SET 
STDL I ST= DELETE can be reversed by entering :SET STDLIST=SAVE into the job stream. Note that the 
: SET command works only on jobs with a spooled $STDLIST. 

EXAMPLE 

!JOB EXAMPLE, MAC.TECHPUB.XGROUP 

! CONTINUE 

!RUN UPDATE. PUB. SYS; PARM=1 ; MAXDATA= 1 6000 

!IF JCW < FATAL THEN 

!SET STDLIST=DELETE 

!ENDIF 

!E0J 
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:SETCATALOG 



Causes the Command Interpreter to search a catalog of user defined commands (UDCs) and establish an 
entry for each command, or to deactivate previously set catalogs. 

SYNTAX 



:SETCATALOG [catfilename\§lookword] \§cat filename [ilochoord] ] . . . ] 



[|SHOW] 
{SYSTEM } 



II 



{ACCOUNT) 



[lUSER=«ser[ .acct]] 



PARAMETERS 

catfilename 



lockuord 
SHOW 



ACCOUNT or SYSTEM 



user[.acct] 



Catalog (UDC) filename. Normally, this file is of a file consisting of one or 
more User Defined Commands (UDCs). When more than one user defined 
command resides in the catalog file, the commands must be separated from 
each other by one line, the first character of which must be an asterisk. If 
you omit catfilename, all UDCs within that file will be deactivated at the 
user, account, system level to which you have access. 

An optional lockword assigned by creator of the file. 

Lists catalogs and UDCs as the user defined commands are initialized. This 
parameter is useful for listing additional information if there is an error in 
UDC initialization. SHOW lists each UDC as it is checked. If an error 
occurs, it is listed after the erroneous UDC. 

Specifies the catalog file being defined or deactivated. ACCOUNT specifies 
that the catalog file being defined or deactivated reset is at the account 
level. ACCOUNT requires Account Manager (AM) capability. SYSTEM 
specifies that the catalog file being defined or deactivated is at the system 
level. SYSTEM requires System Manager (SM) capability. Default is the 
user level catalog. 

The username of the user whose catalog file will be defined or reset. 
Requires Account Manager (AM) capability. 



USE 

This command may be issued from a Session, Job or in BREAK. It may not be issued from a Program. It 
is not Breakable. 
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OPERATION 

The : SETCATALOG command causes the Command Interpreter to search a specially prepared disc file for 
user defined commands. The Command Interpreter then establishes a directory entry for each command 
in the file. 

A user must have READ and LOCK access to the UDC file in order to use the : SETCATALOG command 
and to logon while that UDC file is in effect. Therefore, for account and system level UDCs, the account 
and group file security under which the files reside must allow READ and LOCK access to all users. 
Lock words specified using : SETCATALOG are put into COMMAND. PUB. SYS, so the user need not know the 
lockword to logon. 

Entering : SETCATALOG with no parameters removes all your user level UDC files from the system 
catalog. Note that the files are not purged, but are deleted from the catalog. In order to purge or modify 
a particular UDC file, you must first remove from the system UDC catalog by issuing the : SETCATALOG 
command with a parameter list that does not include that particular UDC filename. 

EXAMPLE 

To create a user defined command (UDC) file named MYCMNDS with the Editor, and have the Command 
Interpreter establish a directory entry for it, enter: 

; EDITOR 

HP32201A.7.15 EDIT/3000 MON, MAY 14, 1985, 8:01 AM 

(C) HEWLETT-PACKARD CO. 1985 

/ ADD 

1 S ** UDC name** 

2 SHOWJOB ** MPE command ** 

3 ** ** Separates UDCs ** 

4 R ** UDC name ** 

5 RESUME ** MPE command ** 

/ KEEP MYCMNDS 
/£ 



END OF SUBSYSTEM 
;SETCATALOG MYCMNDS; SYSTEM 



** Establishes a UDC directory at the system level ** 
** for both commands. This requires SM capability ** 



Now, S and R are now established as system defined commands. If you enter S, the : SHOWJOB MPE 
command will execute; if you enter R, : RESUME will execute. 

If, as Account Manager, you want to establish directory entries in the UDC file for users within your own 
account enter: 

: SETCATALOG ** Requires AM capability ** 

NEWCMNDS; ACCOUNT 
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ADDITIONAL DISCUSSION 

Refer to Section III of this manual. 
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:SETDUMP 



Enables Stack Dump facility and initiates it on abort. 



SYNTAX 



<DB> 
:SETDUMP [<ST>[*. 
<QS> 

[pscii] 



]] 



PARAMETERS 

DB, ST, or OS 



ASCII 



Dumps memory from the stack marker trace and registers at the time of 
abort in a specified job. DB dumps memory from DL to Q (initial) address. 
ST dumps memory from Q (initial) to S address. QS dumps memory from 
Q-63 to S address. The QS parameter is ignored if the ST parameter is 
used. Default is a display of the stack marker trace and all registers at the 
time of an abort. 

Displays ASCII conversion of octal values requested by DB, ST, or QS 
parameters, along with octal display, but only in a job. Default is octal. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

This command allows a display of the stack markers and all registers requested at the time of an abort. 
The stack marker trace is written to $STDLIST. In an interactive session all parameters are ignored, but 
if you have READ and WRITE file access to the program file, :SETDUMP will automatically initiate 
DEBUG. 



EXAMPLES 

To use : SETDUMP in an interactive session, enter: 

t SETDUMP 
Run the program ABC. MAC. TECH PUBS: 

:RUN ABC. MAC. TECH PUBS 
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If the program ABC contains an error, it aborts, , writes the stack marker trace to the current list device, 
enters DEBUG, and displays the following error message: 

ABORT : ABC. MAC. TECH PUBS. *0.?l763 

PROGRAM ERROR #18 : PROCESS QUIT . PARAM = 2 

**» ABORT STACK ANALYSIS **» 

S=001154 DL= 177650 Z=003425 

0=001160 P=000763 LCST= 000 STAT=U, 1 , 1 ,L,0, 1 ,CCG X=000035 

Q=001153 P=177777 LCST= S026 STAT=P, 1 ,0,L,0,0,CCG X=000000 

•DEBUG* PRIV. 0.764 

?E@ ** Terminates DEBUG ** 

PROGRAM TERMINATED IN AN ERROR STATE. (CIERR 976) 



To arm the Stack Dump Facility from a batch job, and display the memory area from the Q (initial) to S 
address, with accompanying ASCII conversion of the octal data, add the following line to your stream job: 

f SETPUMP ST; ASCI I 

ADDITIONAL DISCUSSION 

MPE Debug/Stack Dump Reference Manual (30000-90012). 
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:SETJCW 



Creates or assigns a value to a Job Control Word (JCW). 



SYNTAX 



: SET JCW jcwname delimiter Value [\ I value] 



PARAMETERS 

jctiname 



delimiter 
value 



USE 



The name of a new or existing user or system defined Job Control Word 
(JCW). You can use "§" to specify all currently defined JCWs. 

You may not specify the system reserved JCWs HPMINUTE, HPHOUR, 
HPDAY, HPDATE, HPMONTH, or HPYEAR. 

One or more punctuation characters or spaces, except "%" and "-". Whatever 
character is used will delimit the name and value. 

One of the following: 

1. An octal number between and %\ 77777, inclusive. 

2. A decimal number between and 65535, inclusive. 

3. An MPE-defined JCW value mnemonic (OK for 0; WARN for 16,384; 
FATAL for 32,768; SYSTEM for 49,152 ) or an offset value of a 
mnemonic (0K3, etc). 

4. The name of an existing JCW. 

All specified values must be in the range of to 65,535, inclusive. If the 
option "+" or "-" is used, the result of the indicated operation must also be 
within the range of to 65 , 535, inclusive. 



This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

JOB CONTROL WORDS 

A Job Control Word (JCW) is a flag that allows information to be passed between processes within a single 
job or session. There are three forms of JCWs: system defined, user defined, and system reserved. 
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JCWs can be tested against specific values. The user can program conditional statements that act 
according to the results of these tests. The user defined JCWs can also be set to user-selected values so 
that they reflect the completion of steps within the setting process. System defined JCWs can be used to 
determine whether certain events have occurred within MPE. 

The values in the system reserved JCWs can be inspected by the user, but not altered. 

The contents of a JCW may be displayed using the : SHOWJCW command. 

JCW Values and Mnemonics 

JCWs may be assigned any positive integer value between and 65,535 inclusive (%0 and %1 77777). 
These values are treated as 16-bit unsigned integers by MPE, since all 16 bits are used for numeric 
information, rather than using the most significant bit as a sign bit. 

MPE treats the two most significant bits of a JCW in a special way: the bits define "bases" or "steps" of 
1 6K each. Each of these steps is given a mnemonic to simplify references to it or to the numbers between 
steps. If the 14 least significant bits are considered to be zeros, the two "step" bits, step value (in decimal), 
and mnemonic have the following relationship: 

Bit Value Step Value Mnemonic 

00 OK 

01 16,384 WARN 

10 32,768 FATAL 

11 49,152 SYSTEM 

It is important to remember that these mnemonics are not the names of JCWs. They cannot be used as 
user defined JCW names. 

You may use a combination of mnemonics and numbers to indicate numeric values between steps. If you 
specify a mnemonic and a number with no intervening spaces, an implied addition takes place. For 
example, "WARN3" has a value of 16,387, since it is "WARN" (16,384) plus 3. The value of the mnemonic 
plus the appended number value may not exceed 65,535. Again, no valid value of the form: 
mnemon ic [number ] may be used as a valid user defined jcwname. An explicit addition or subtraction can 
also be specified, using a "+" or "-" sign, as in "OK+7" (7) or fdWARN-4" (16,380). A mnemonic may also 
be added to another mnemonic: "WARN+FATAL". 

The result of a mathematical operation must be in the range of to 65,535; inclusive, if the number is 
out of range, an error message will be generated and the value of the JCW will remain unchanged. When 
the result of an operation is greater than the value of the next "step", the JCW value displayed by the 
: SHOWJCW command will be the mnemonic of the higher step plus any offset. For example, the value 
"OK+16385" will be displayed as "WARN1". 
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User Defined JCWs 

User defined JCWs are created and initialized to a value by the :SETJCW command or PUTJCW intrinsic. 
The JCW name contains alphanumeric characters and must begin with an alphabetic character. The 
name can be up to 255 characters long. The value assigned to the JCW must be in the range of to 
65,535, inclusive. 

The : SET JCW command scans MPE's JCW table for the name of the specified JCW (jewname). If the 
specified name is found, the JCW is set to value. If the jewname is not found, it is created and set to value. 
The term "value" as used here means the explicitly stated or the computed value. 

You may not begin a JCW name with the mnemonic names OK, WARN, FATAL, or SYSTEM, unless you 
append a number to the mnemonic such that the computed value exceeds 65,535 (e.g. WARN999999, or 
SYSTEM20000). If the computed value exceeds 65,535, MPE will not recognize the term as a valid 
mnemonic, and will treat it as the name of a JCW. This restriction is intended to eliminate the possibility 
of an ambiguous JCW assignment. For example, it is unclear from the following two commands whether 
the JCW X is equal to 1 00 or to 0: 

: SETJCW OK=100 
; SET JCW X=0K 

Naming a JCW with a mnemonic or predefined JCW value will result in an error message, as in the 
following example: 

; SET JCW OK200=1982 

JCWNAME CANNOT BE A VALID JCW VALUE (CIERR 1725) 

Negative or out -of -range JCW values will cause the following error message to be displayed 

VALUE NOT IN RANGE— LEGAL RANGE IS TO 65535 (CIERR 1712) 

System Defined JCWs 

MPE has two system defined JCWs that are created for each job and session: JCW and CI ERROR. The JCW 
named "JCW" is always initialized to zero at the beginning of the job or session and will remain zero, unless 
fatal errors occur, or unless the user changes the value. There are two special values for the system 
defined JCW: 

%1 40000 (System 0) Program aborted per user request. 

>% 1 40000 Program terminated in an error state. 



The "CI ERROR" JCW tracks Command Interpreter (CI) errors. CI ERROR is set to zero at the beginning of 
the job or session. If a Command Interpreter error occurs, CI ERROR is updated to reflect the current CI 
error message number. A valid command will not reset CI ERROR to zero. 

Users are advised not to alter the values of the "CI ERROR" and "JCW" Job Control Words. User defined 
JCWs should be used for information the user wishes to control. 



( 
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The following example shows the use of the CI ERROR JCW: 
: LISTTF 

UNKNOWN COMMAND NAME. (CIERR 975) 
: SHOWJCW CI ERROR 
CIERROR = 975 
; RUN 

NO PROGRAM FILE SPECIFIED. (CIERR 600) 

i SHOWJCW CIERROR 

CIERROR = 600 

: LISTF ABC 

ABC 

: SHOWJCW CIERROR 

CIERROR=600 



System Reserved JCWs 



The system reserved JCWs are HPMINUTE, HPHOUR, HPDAY, HPDATE, HPMONTH, and HPYEAR. 
They contain system -assigned minute, hour, day, date, month, and year information. If the user attempts 
to assign values, an error message is displayed. You can retrieve the values in these JCWs with the 
FIND JCW intrinsic. The values can also be tested if the JCW is used with an : IF command. The names of 
the system reserved JCWs are reserved. 

The following lists system reserved JCWs and possible values: 

HPDAY Day of the week. The possible integers are 1 through 7. Sunday is indicated 

by 1. Saturday is indicated by 7. 

HPDATE Day of the month. The possible integers are 1 through 31. 

HPMONTH Month of the year. The possible integers are 1 through 12. January is 

indicated by 1. 

HPYEAR Year of the century. The possible integers are 00 through 99. 

HPHOUR Hour of the day. The possible integers are through 23. 

HPMINUTE Minute of the hour. The possible integers are through 59. 

Conditional Execution Using JCWs 

JCWs are typically used to control the flow of batch jobs, based on events that take place within the job. 
You can use the MPE : IF/THEN and : ELSE statements to test JCW values. 
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The following example illustrates a conditional execution function. The sample job runs a program that 
edits, verifies, and counts valid transactions (CHEKPROG). If no fatal errors occur, the job runs the program 
SHIPPROG, which schedules shipments. The job then runs FINALRPT, which produces a final report. If 
fatal errors do occur, the CHECKPROG will set the value of the the JCW "CHEKPROGSTAT" to FATAL, and 
SHIPPROG is not run. Instead, ERRORRPT is run, which produces an error report. A final report is also 
produced by FINALRPT. 

You can display the contents of a system defined JCW with the : SHOWJCW command only if you specify 
the jcwname. Otherwise, : SHOWJCW will not display system defined JCWs. 

SETJCW CHEKPROGSTAT=OK 

CONTINUE ** Prevents abort in case of errors. ** 

RUN CHEKPROG ** Edit, verify, and count valid transactions. ** 

IF CHEKPROGSTAT< FATAL THEN ** If no fatal errors, schedule shipments. ** 

RUN SHIPPROG ** Schedule shipments. ** 

ELSE 

SHOWJCW CHEKPROGSTAT 

RUN ERRORRPT ** Produce error report and reset JCW to 0. ** 

ENDIF 
RUN FINALRPT ** Produce final report. ** 



EXAMPLES 

To set the Job Control Word CURR1 to 100 , enter 

: SETJCW CURR1.100 ** The comma (,) is the delimiter and is used as an "=". ** 
To set CURR1 to the value of the mnemonic WARN , enter: 

: SETJCW CURR1/WARN ** The slash (/) is the delimiter and is used as an "=". ** 
To use an arithmetic operation to set a JCW, enter: 

: SETJCW XX=5+6 
To schedule a full backup job on Saturdays and a partial backup job on the other days of the week, enter: 

; SETJCW FRIDAY=6 

; IF HPDAY «■ FRIDAY THEN 

SCHEDJOB FULLBKUP;IN=1 
: ELSE 

SCHEDJOB PARTBKUP;IN=1 
:ENDIF 
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:SETMSG 



Enables or disables the receipt of user or operator messages at the standard list device. 



SYNTAX 



: SETMSG 



{OFF} 
{ON } 



PARAMETERS 

OFF 
ON 



Sets job or session to QUIET mode and blocks the receipt of :TELL command 
messages from other users. 

Enables user or operator messages to be received and displayed at the 
standard list device. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

Allows job or session to receive or block :TELL messages from other users. :WARN messages from the 
System Operator override QUIET mode and are received and displayed. Messages can be sent to the device 
designated as the System Console, when it is running in QUIET mode, by using the : TEL LOP command. 



EXAMPLE 

To block messages, enter: 
: SETMSG OFF 

To receive messages, enter: 
: SETMSG ON 
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:SHOWALLOCATE 



Displays status information about ALLOCATE and/or AUTOALLOCATE. (Available on G.02.BO 
releases or later. ) 

Syntax 



STATUS [^listfile] 

:SHOWALLOCATE [ ALLOCATE [A fileset] \MUstfile]] ] 

AUTO [AfUeset] Ulistfile]] 

ALL [AfUeset] [^listfile]] 



PARAMETERS 



STATUS Request to display a summary of status information that includes: 

1. Status of AUTOALLOCATE, either ON or OFF 

2. Number of programs allocated 

3. Number of programs autoallocated 

4. Size and percentage of utilization of the following system tables: 

Code segment table, code segment table extension, CSTX table and 
loader segment table. 

ALLOCATE Request to display ALLOCATEd programs specified by fileset and the 

number of users sharing each program. 

AUTO Request to display AUTOALLOCATEd programs specified by fileset, and 

the number of users sharing each program. 

ALL Request to display all information provided by parameters: STATUS, 

ALLOCATE and AUTO. This is the Default parameter. 

fileset Specifies the set of files to be searched for. Default is @.@.@. The format 

of this parameter is: 

filedesignator[ .groupdesignator[ .acctdesignator] ] 

Fileset can be entered in any of the following formats and may use wild 
card characters in any order as replacements. 

f i le . group, account Showallocate file named in specified group and account. 

f i le. group. % Showallocate specified file named in specified group, any account. 

f i le . §. 6 Showallocate specified file name in any group and any account. 

6. group, account Showallocate all files in specified group and account. 

6. §. account Showallocate all files in all groups in specified account. 
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$.€.§ Showal locate all files in system. Default. 

@ Showallocate all files in all groups in all accounts. 

©.group Showallocate all files in specified group, any account. 

The characters §, #, and ? can be used as "wild card" characters in the 
fileset parameter. These wild card characters have the following meanings: 

6 Specifies zero or more alphanumeric characters. 

# Specifies one numeric character. 

? Specifies one alphanumeric character. 

These characters can be used as follows: 

n@ All files starting with the character "n". 

6n All files ending with the character "n". 

nfix All files starting with the character "n" and ending 

with the character "x". 

n##. .# All files starting with the character "n" followed by up 

to seven digits (useful for listing all EDIT/3000 
temporary files). 

?n@ All files whose second character is "n". 

n? All two-character files starting with the character "n". 

?n All two-character files ending with character "n". 

listfile Name of an output file to which all ouput is written. It is automatically 

specified as an ASCII file with variable length records and the following 
characteristics: closed in a permanent domain, user-supplied carriage 
control (CCTL), OUT access mode, and EXC (exclusive access) option. This 
parameter may also be a back -referenced file. Default is SSTDLIST. 

USE 

This command may be issued from a Session, Job, Program or in Break mode and it is Breakable. A user 
must have System Supervisor (OP) capability to use this command. 

OPERATION 

This command generates the status information of the specified system tables and lists files that are 
al located/autoallocated. 
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EXAMPLES 

To display status information for all allocated files in the system, enter: 



:SHOWALLOCATE ALLOCATE 
ALLOCATED PROGRAMS 



SHARE COUNT 



EDITOR . PUB. SYS 

FCOPY. PUB. SYS 2 

LISTDIR5. PUB. SYS 1 

NUMBER OF PROGRAMS FOUND = 3 

To display status information for all autoallocated files starting with a character S in the account named 
SYS, enter: 

:SHOWALLOCATE AUTO, S@.@. SYS 

AUTOALLOCATED PROGRAMS SHARE COUNT 

SPOOK5 . PUB . SYS 1 

SLPATCH . PUB. SYS 

NUMBER OF PROGRAMS FOUND = 2 

To display summary status information regarding allocation, enter: 

:SHOWALLOCATE STATUS 

ALLOCATION STATUS: 

AUTOALLOCATE IS ON 

NUMBER OF PROGARAMS ALLOCATED = 3 

NUMBER OF PROGRAMS AUTOALLOCATED = 7 



ALLOCATION RELATED TABLES 



CODE SEGMENT TABLE 

CODE SEGMENT TABLE EXTENSION 

CSTX BLOCK TABLE 

LOADER SEGMENT TABLE 



SIZE % USED 







191 


52 


1023 


9 


144 


13 


32000 


3 
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:SHOWALLOW 

Displays which Operator commands have been allowed: 

SYNTAX 



{user.acct} 
:SHOWALLOW [<££« >] 

{@.e } 



PARAMETERS 

user Defines a particular user. 

acct Defines a particular account. 

6 All users, if used in place of user, or all accounts, if substituted for acct. 

Default is that the logged -on user, account, and group are displayed. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). The user must have Account Manager (AM) or System Manager (SM) capability to execute this 
command for other groups or accounts. 

OPERATION 

This command displays which Operator commands have been allowed to specific users if the user.acct 
form is entered. If the g.@ form is entered, the commands allowed to all users in all accounts are 
displayed. System Manager (SM) capability is required to specify g.g ; Account Managers (AM capability) 
may specify all users in their own account. When rSHOWALLOW is executed from the system console, g 
may be substituted for user and/or acct. In addition, :SHOWALLOW separately lists which Operator 
commands have been globally allowed. 

EXAMPLE 

To list the Operator commands allowed to the user MAC, PUB. SYS, enter: 

; SHOWALLOW USER. SYS 
#S86 USER. SYS 

USER HAS THE FOLLOWING COMMANDS ALLOWED: 
ABORTIO ACCEPT DOWN GIVE 

THERE ARE NO GLOBAL ALLOWS DEFINED. 

ADDITIONAL DISCUSSION 

Refer to the : ALLOW command. 
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:SHOWCACHE 



Displays a summary of disc caching performance. Disc caching software is not included in the 
Fundamental Operating Software, and must be purchased separately. 

SYNTAX 



: SHOWCACHE 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

The : SHOWCACHE command summarizes the performance of disc caching on your system, displaying nine 
columns of information (shown below). Since it only allows you to look at disc caching performance, and 
prohibits the modification of caching parameters, any user may execute : SHOWCACHE. 



: SHOWCACHE 
















DISC CACHE 


READ 


WRITE 




PROCESS 




% OF 


CACHE 


LDEV REQUESTS 


HIT% 


HIT* 


READ?. 


STOPS 


K- BYTES 


MEMORY 


DOMAINS 


1 21529 


93 


85 


82 


1705 


686 


11 


218 


2 35093 


77 


59 


69 


6155 


2760 


45 


675 


Total 56622 


83 


65 


74 


7860 


3446 


57 


893 



62% of user I/Os eliminated. 
Data overhead is 229K bytes. 
Sequential fetch quantum is 96 sectors. 
Random fetch quantum is 16 sectors. 
Block on Write = NO. 
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Each column of information provides the following information: 



DISC 
LDEV 



CACHE 
REQUESTS 



READ 
HIT* 



WRITE 
HIT% 



READ* 

PROCESS 
STOPS 



K- BYTES 



% OF 
MEMORY 

CACHE 
DOMAINS 



Logical device number(s) of the disc(s) being cached. Read across the row to 
see the other entries on a particular disc. The bottom row is a total across 
all discs. 

Tally of the number of logical disc I/O requests against caching. This is a 
double -word counter and resets to zero automatically when caching is 
started on the disc, or when the counter overflows. 

Cumulative percentage of logical disc I/O on read requests: read requests 
that were satified by data found in a main memory cache domain when the 
read request occurred. 

Cumulative percentage of logical disc I/O on writes requests: write requests 
that were accomplished in a main memory cache domain when the write 
request occurred. 

Percentage of logical disc I/Os in the system which were read requests. 

Number of times a process stopped in order to complete a cache I/O 
request. Process Stops occur due to read misses, or due to write hits in which 
the cached region is currently being posted to disc. This is a double-word 
counter which resets to zero if it overflows. 

Count of the number of thousands of bytes (1024-byte groups) which are 
currently being used for main memory cache domains. 

Percentage of the total memory in the machine which is currently allocated 
for use by cache domains. 

Number of cache domains in memory. 



In addition, the :SHOWCACHE command displays information about data overhead, which is the current 
dynamic data structure overhead used to support disc caching. The sequential fetch and random fetch 
quantums, established by default or selected with the : CACHECONTROL command, specify the number of 
sectors read from the disc for sequential and random access files respectively. BLOCKONWRITE, which is 
also set with the : CACHECONTROL command, determines whether or not MPE will block the process until 
posting of the cache buffers to disc is complete. 

ADDITIONAL DISCUSSION 

The rSHOWCACHE command does not require any special capabilities. However, you are allowed only to 
look at disc caching performance and not to change any of the options or parameters. If you want to 
change the disc caching performance, refer to the :STARTCACHE, :STOPCACHE, and .-CACHECONTROL 
commands in this manual. Refer also to the FSETMODE intrinsic in MPE V Intrinsics Manual 
(32033-90007). 
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:SHOWCATALOG 



Lists user defined command (UDC) files. 



SYNTAX 



:SHOWCATALOG [list file] 

[!USER=«ser [ . acct ] 



PARAMETERS 

listfile 
user[.acct] 



An arbitrary filename, used to identify the UDC file when the output of 
: SHOWCATALOG is sent to a printer. The output may be redirected with a 
previous :FILE command. Default is that UDC files are displayed on your 
terminal (the $STDLIST device). 

A particular user whose UDC filenames will be displayed on the screen or 
sent to a listfile; the contents of the files are not displayed. 

The wildcard characters @, #, and ? may be used in user[ .acct] as you 
would use them in the specification of any user or any account, where 



6 
# 



One or more alphanumeric characters. Used by itself, € 
denotes "all members of the set". 

One numeric character. 

One alphanumeric character. 



Each wildcard character counts toward the eight character limit for user or 
accr. 



USE 

This command may be issued from a Session, Job, or in BREAK. It may not be issued from a Program. It 
is Breakable (aborts execution). 

OPERATION 

The : SHOWCATALOG command lists user defined command (UDC) files. Unless the output is redirected to 
another device with the :FILE command, as shown in "EXAMPLE", the listing appears on your terminal. 
It indicates at which level (user, account, or system) the files have been defined, so that you may display 
the current catalog before adding or deleting system level UDCs (if you are the System Manager) or 
account level UDCs (if you are Account Manager). 
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EXAMPLES 

To list system, account, and user level UDC files on your terminal, enter: 
: SHOWCATALOG 

To store the current UDC file on disc as "LFILE" (which may also be printed) enter 

; BUI LP LFILE 

:FILE LFILE, OLD;DEV=DISC 

;SHOWCATALOG « LFILE 

ADDITIONAL DISCUSSION 

Refer to the discussion of UDCs in Section III of this manual. 
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:SHOWCOM 



Displays status information about a communication device. 

SYNTAX 



PARAMETERS 

Ideo The logical device number of a communication system device. 

ERRORS Displays the full status list. If not specified, an abbreviated list is 

displayed. 

RESET Reset all status information to zero after it has been displayed. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console. * 

• Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

The status information generated by this command can be used to determine communication line activity 
and quality. It includes: 

• Number of messages sent and received. 

• Last recoverable and irrecoverable errors. 

• Number of recoverable and irrecoverable errors. 

• Number of retransmissions, response timeouts, clear-to-send losses, and underruns. 

• Number of check character (BCC/CRC) errors, receive timeouts, carrier losses, and overruns. 

• Line state (closed, connected or disconnected). 

Note that clear-to-send losses and carrier losses will be valid only for communication lines configured as 
full duplex. 

When the line is OPEN, connected or disconnected, the status information displayed is a duplicate of the 
statistics generated from the last opening of the line until : SHOWCOM command is invoked. When the line 
is CLOSED, the status information obtained at the close of the line reflects the statistics generated during 
the last open/close sequence. 



2-326 



EXAMPLES 

To display the status of logical device 1 8, enter: 
:SHOWCOM 18 



LDN - 18 



MESSAGES SENT 



MESSAGES RECVD 



LAST RECOVERABLE ERROR 
LAST IRRECOVERABLE ERROR 
LINE IS CLOSED 

To display the full status of logical device 1 8, enter: 




201 



: SHOWCOM 18;ERR0RS 

TRANSMIT LDN - 18 

MESSAGES SENT 

RETRANSMISSIONS 

RESPONSE TIMEOUTS 

UNDERRUNS 

CLR TO SEND LOSSES 



RECEIVE 
MESSAGES RECVD 
BCC/CRC ERRORS 
RECV TIMEOUTS 
OVERRUNS 
CARRIER LOSSES 



# OF RECOVERABLE ERRORS 
LAST RECOVERABLE ERROR 

# OF IRRECOVERABLE ERRORS 
LAST IRRECOVERABLE ERROR 
LINE IS CLOSED 



NOTE 



The "LAST IRRECOVERABLE" and "LAST RECOVERABLE" 
error codes are specified in the Communications Handbook 
(30000-90105). 
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SHOWDEV 



Reports the status of input/output devices and information about any associated Access Control 
Definitions (ACDs). 



SYNTAX 



: SHOWDEV 



[Ideo 



) [;ACD] 



[classname] 



PARAMETERS 

IdeO 

classname 

ACD 



Logical device number of device for which status information is to be 
displayed. This number is unique for each device. Default is that status 
information for all system devices on the system is displayed. 

Device class name of device(s) for which status information is to be 
displayed. This name may apply to several devices. Default is that status 
information for all devices on the system is displayed. 

Indicates that ACD information related to the requested device set is to be 
displayed. ACD information will only be displayed if it exists for a device 
and if you are allowed access to the information. 



USE 



This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 

OPERATION 

Displays the status information for all input/output devices on the system. The display appears in the 
following format: 



: SHOWDEV 
LDEV AVAIL 



OWNERSHIP 



VOL ID 



DEN ASSOCIATION 



1 DISC 43 FILES 

6 SPOOLED SPOOLER OUT 
8 AVAIL 

20 A UNAVAIL #S31 1 : 2 FILES 
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The following items may appear in the listing, always displayed on the standard list device: 



COLUMN 

LDEV 



AVAIL 



OWNERSHIP 



MEANING 

Includes the logical device number and may include one of the following: 

J Accepts jobs. 

D Accepts data. 

A Accepts jobs and data. 

Lists the availability of devices and discs as follows: 

AVAI L The device is available as a real, nonsharable device. 

SPOOLED The device is available via input or output spooling. 

UNAVAIL The device is not available (it is under the control of a 

job, session or a system process such as a spooler). 

DISC The device is a disc and is always available. 

DISC (RPS) The device is a CS- 80 disc on which Rotational Position 

(G. 00. 00) Sensing (RPS) has been enabled. 

Includes device ownership and may include one of the following: 

SYS Controlled by the system. If tnnn appears, it specifies 

the Process Identification Number (PIN) of the 
controlling process (program). 



SPOOLER IN 
SPOOLER OUT 
fJnnn 
§Snnn 
DIAG 

nn FILES 

DOWN 

DP 



Input spooling in effect, controlled by spooler. 

Output spooling in effect, controlled by spooler. 

Controlled by the indicated job. 

Controlled by indicated session. 

Device has been allocated to diagnostic testing by System 
Operator via the :GIVE command. 

Indicates number of files currently in use on a disc. 

Device is offline, requested by System Operator via the 
: DOWN command. 

Device is being taken offline ( : DOWN command operation 
pending). 
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COLUMN 

VOL ID 



MEANING 

The volume identification and may include one of the following: 



IBM 



ANSI 



The named magnetic tape volume has a label written in 
the I BM format. 

The named magnetic taped volume has a label written in 
the ANSI format. 



DEN 



ASSOCIATION 



NOLABEL The named magnetic tape volume has no label. Default. 

Density of the tape and may include one of the following: 

6250 Density of 6250 BPI (bytes-per-inch). 

1600 Density of 1600 BPI or the density of the tape is 

unrecognizable. 

Indicates the logical devices by device class which have been established by 
the user with the : ASSOCIATE command. 



EXAMPLES 

To display the status of the device identified by logical device number 5 enter: 
:SHOWDEV 5 



LDEV AVAIL OWNERSHIP VOLID 

5 SPOOLED SPOOLER OUT 
To display the status of all devices of the device class CARD, enter: 
:SH0WDEV CARD 



DEN ASSOCIATION 



OWNERSHIP 



VOLID 



DEN ASSOCIATION 



LDEV AVAIL 

6 A AVAIL 

To display Access Control Definitions (ACDs) associated with a device, enter: 

:SHOWDEV 17;ACD 

LDEV AVAIL OWNERSHIP VOLID DEN ASSOCIATION 
17 SPOOLED SPOOLER OUT 

ACD ENTRIES: JOE. DOE : R 
€.€ : X 
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:SHOWIN 



Reports the status of input devicef iles. 



SYNTAX 



:SHOWIN 



[flnnn 

[STATUS 

[SP 

[item[§item[§. 



]]] 



PARAMETER 

tlnnn 
STATUS 



SP 



item 



Identifier of particular input devicefile for which information is to be 
displayed. Default is that MPE displays information for all input 
devicef iles used by the logon job or session. 

Summarizes the status information for all current input devicefiles. 
Default is that MPE displays information for all input devicefiles used by 
the logon job or session. The information appears in following format: 

8 FILES 

ACTIVE 

READY ;INCL SPOOFLES, DEFERRED 

8 OPENED; INCL SPOOFLES 

SPOOFLES; SECTORS 
LOCKED; INCLUDING SPOOFLES 

Displays the status information for the currently spooled input devicefiles 
associated with the logon job or session. Default is a display of status 
information for all input devicefiles. 

Displays the status of current input devicefiles as identified. Default is 
that MPE displays status information for all input devicefiles used by this 
job. The syntax appears on the next page. 
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Syntax for Item 



[DEV=ldei> 



] 



<SJ > 

<8S > 

[JOB={§ }] 

<[#]Jwro> 
{[#]Smw> 

{ACTIVE > 
[{OPENED > ] 
{READY > 



Parameters for Item 

Idea 



JOB= 



Displays the status of input devicef iles identified by logical device number 
Idev. 

Displays the status of input devicef iles. JOB= may be one of the following 
options: 



e 

[t]Jnnn 
[#]Snm? 



Displays the status of input devicefiles for all jobs. 

Displays the status of input devicefiles for all sessions. 

Displays the devicefiles for all jobs and sessions. 

Displays the status of all input devicefiles for a specified 
job. 

Displays the status of all input devicefiles for a specified 
session. 

Default is <8. 



ACTIVE, OPENED, 
or READY 



Displays the status of all input files in a specified state. ACTIVE displays the 
status of ACTIVE devicefiles. OPENED displays the status of OPENED 
devicefiles. READY displays the status of READY devicefiles. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 
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OPERATION 



This command displays the status information about one or more currently defined input devicefiles. This 
information reflects the status at the time the command is entered, and always appears on the standard 
list device. Except for the keyword STATUS, which has its own format (refer to "Parameter"), the format 
of the information is: 



DEV/CL DFID 
10 #11088 



JOBNUM FNAME STATE FRM SPACE RANK PRI #C 
#J133 $STDIN OPENED 



The information displayed in this format is defined as follows: 



COLUMN 

DEV/CL 

DFID 

JOBNUM 

FNAME 
STATE 



FRM 

SPACE 

RANK 

PRI 

#C 



MEANING 

Logical device number of device. 

Device file identification in the form §Innn. 

Job or session number (jsnum) of job/session using the devicef ile, if not used 
for READY or ACTIVE data. Otherwise, the job/session name appears on 
the line following standard device information. 

File name associated with the devicefile. 

One of the following: 

ACTIVE Input being read from a spooled device to a disc. 



READY 



Input spooling completed: file is now ready for use by a 
program. 



OPENED A file is being accessed by a program. 

Not applicable to input files. 

Approximate disc space currently used (in sectors), for input spoolf iles only. 

Not applicable to input files. 

Not applicable to input files. 

Not applicable to input files. 
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EXAMPLES 

The following is an example of how to determine the status of an individual input devicefile: 
rSHOWIN #180 



I 



DEV/CL DFID JOBNUM FNAME 
43 #180 #S37 $STDIN 



STATE FRM SPACE RANK PRI #C 
OPENED 8 



If you do not know the devicefile identification number (DFID) of the devicefile whose status you want to 
determine, you may request the status display by entering either the logical device number or the device 
class name of the device on which the file originated: 



; SHOWIN DEV=43 

DEV/CL DFID JOBNUM FNAME 
43 #180 #S37 $STDIN 



STATE 
OPENED 



FRM SPACE RANK PRI #C 



You may also request displays of devicefile information using various combinations of qualifications 
(devices, jobs/sessions, and states). For example, to display information about all OPENED input devicefiles 
used by all sessions (but not jobs) in the system, enter: 



;SHOWIN J0B=eS;0PENED 



DEV/CL 


DFID 


JOBNUM 


FNAME 


STATE 


7 


#181 


#S38 


MASTER 


OPENED 


26 


#136 


#S18 


$STDIN 


OPENED 


32 


#185 


#S41 


$STDIN 


OPENED 


34 


#158 


#S26 


$STDIN 


OPENED 


42 


#164 


#S28 


$STDIN 


OPENED 


43 


#180 


#S37 


$STDIN 


OPENED 


50 


#184 


#S40 


$STDIN 


OPENED 


51 


#135 


#S17 


$STDIN 


OPENED 



8 FILES (DISPLAYED): 

SPOOFLES: SECTORS 



FRM SPACE RANK PRI #C 
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:SHOWJCW 



Displays current state of one or more Job Control Words (JCWs). 

SYNTAX 



:SHOWJCW [jctiname] 



PARAMETERS 

jcwname The name of a valid Job Control Word (JCW). Default is that all user and 

system defined JWCs are displayed. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 

OPERATION 

The rSHOWJCW command is used to display the current state of one or more Job Control Words, JCWs. 
Specifying a particular JCW (user or system defined , or system reserved) displays the state of that 
particular JCW. If you do not specify a particular JCW, user defined and system defined JCWs are 
displayed. The value of the third type of JCW, system reserved JCW, is displayed only if you specifically 
enter its jcwname. 

You may retrieve the value assigned a JCW with the FINDJCW intrinsic, then test it with an :IF 
command. In this way, the value of a given JCW can be used to conditionally execute another instruction 
or set of instructions. For example: 

! CONTINUE 

•SPL MYPROG.MYUSL 

•IF JCW>=FATAL THEN 

! TELL MAC. TECH PUBS; COMPILE FAILED 

•ELSE 

• TELL MAC. TECH PUBS; COMPILE COMPLETED 

•ENDIF 



2-335 



EXAMPLE 

To show the current state of all user and system defined JCWs, enter: 

: SHOWJCW 
JCW = 
CIERROR = 

To display the current state of a valid user defined Job Control Word named JCW1, enter: 

; SHOWJCW JCW1 
JCW 1=3 

To display the contents of a system reserved JCW, enter: 

t SHOWJCW HPDAY 
HPDAY=4 

ADDITIONAL DISCUSSION 

Refer to : SETJCW in this section. 
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SHOWJOB 



Displays the status information about jobs/sessions. 

SYNTAX 



: SHOWJOB 



[[t]Snnn 

[[#]Jnnn 

[STATUS 

[SCHED 

[item\Mitem[§.. . .]] 



[U*listfile] 



PARAMETERS 

[§]Snnn 

[§]Jnnn 
STATUS 



SCHED 



•listfile 



item 



The session number (assigned by MPE) of the session for which the status 
information is to be displayed. The information appears in Type I format, 
described under "OPERATION". Default is that the status information for 
all jobs/sessions is displayed. 

The job number (assigned by MPE) of the job for which status information 
is to be displayed. The information is in Type I format, described under 
"OPERATION". Default is that the status information for all jobs/sessions 
is displayed. 

Lists the number of jobs and sessions in each processing state and the 
current job fence and job/session limits. This information is in Type II 
format, described under "OPERATION". Default is that the status 
information for all job/sessions is displayed. 



Displays only the scheduled jobs. 
described under "OPERATION". 



The information is in Type III format, 



Formal file designator of the file on which the output listing is written. A 
backreference to a :FILE equation is required. The listfile is a temporary 
file with record size of 256 bytes, blocked one record per block, with 
Carriage Control (CCTL), with the time and date displayed. You can 
override the default characteristics of listfile with the :FILE command. 
Defaultis$STDLIST. 

A list of jobs/sessions whose status is displayed. Default is that the status 
information for all jobs/sessions is displayed. The syntax appears below. 
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Syntax for Item 



{§J 


} 


{INTRO 




} 


<§s 


} 


{EXEC 




> 


[JOB={@ 


}] 


[;{SUSP 




} 


{ [jsnamm, 


\] username} 












{WAIT 


Lin J 

[*D] 


} 



Parameters for Item 

JOB= A list of jobs/sessions for which status information is to be displayed. Use 

one of the following options: 

§J Displays status information for all jobs. 

@S Displays status information for all sessions. 

% Displays status information for all jobs and 

sessions. 



[jsname 1 J . username The jsname is an optional name given to the 
.acctname session or job by the user. The username 

parameter is the username established by the 
Account Manager. This name may consist of one 
to eight alphanumeric characters beginning with 
an alphabetic character. The accountname 
parameter is the name of the account established 
by the System Manager. This name may consist 
of one to eight alphanumeric characters 
beginning with an alphabetic character. The "&' 
can be used to replace the jsname or username in 
a specified account. 

INTRO, EXEC, Displays the status of all jobs or sessions in a specified state. INTRO means 

SUSP, or WAIT that the job is introduced. In this case the spooler process validates the 

: JOB command and, if the job is legitimate, copies the job input records to 
disc. EXEC means that the job is executing. SUSP means that the job or 
session is suspended, because table entries or system resources are 
unavailable. WAIT means that there are no available list devices for the job. 
WAIT has the following subparameters: 

N Displays the status of nondeferred READY devicefiles. 

D Displays the status of deferred READY devicefiles. 
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If information for only one devicefile is displayed, output is in Type I 
format; if information for more than one devicefile is displayed, output is 
in Type I followed by Type II format. (Format types are described under 
"OPERATION".) 



USE 



This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 



OPERATION 

This command enables you to determine the number of jobs and sessions in each processing state, the 
current job fence and job/session limits, and allows you to keep track of individual spooled and streamed 
jobs that are entered in the system. The output appears in two possible formats or in a combination of 
both formats: 



Type I: 

JOBNUM STATE IPRI JIN JLIST 
#S16 EXEC 45 45 
JOBFENCE= 0; JLIHIT = 3; 

Type II: 



7 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

7 EXEC; INCL 7 SESSIONS 

SUSP 
J0BFENCE= 0; JLIMIT= 3; 



INTRODUCED JOB NAME 
MON 7: 08 A TEST. PUBS 
SLIMIT= 16 



SLIMIT= 16 



If the :SHOWJOB SCHED command is used, the output is displayed as shown below. The STATE field shows 
that the job is scheduled. The SCHEDULED- INTRO field shows the time and date the job will be 
introduced to the system. Note that the scheduled jobs are listed in the order in which they will be 
introduced to the system. If you enter only the : SHOWJOB command, the formatted output for jobs and 
sessions in the INTRO, WAIT, and EXEC states will be displayed first in the Type I and Type II formats. The 
formatted data for jobs in the SCHED state is displayed last and is in the Type III format. 

Type III: 

CURRENT: 5/13/85 1600 



JOBNUM STATE IPRI JIN JLIST 



SCHEDULED- INTRO JOB NAME 



#J38 
#J23 

#J25 



SCHED 
SCHED 
SCHED 



3 
8 
8 



10 
10 
10 



6 

PP 

LP 



5/16/84 11:24 

5/25/84 8:01 

7/4/84 18:05 



NOTHING, JON. OSE 
REPORT, MGR.OSE 
FIREWORK, UNCLE. SAM 



3 SCHEDULED J0B(S) 
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EXAMPLES 

To determine the number of jobs and sessions in each processing state, the current job fence and the 
job/session limits, enter: 

: SHOWJOB STATUS 
6 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

6 EXEC; INCL 6 SESSIONS 

SUSP 

JOBFENCE= 0; JLIMIT= 3; SLIMIT= 16 

To get a report on all jobs and sessions in the system, enter: 

: SH0WJ0B 

JOBNUH STATE IPRI JIN JLIST INTRODUCED JOB NAME 
#S745 EXEC 29 29 MON 2:53P DL.SPL.ALANG 
#S746 EXEC 26 26 MON 2:53P CLI.AOPSYS 

2 JOBS: 

1 INTRO 

WAIT; INCL DEFERRED 

2 EXEC; INCL 2 SESSIONS 
SUSP 

JOBFENCE= 2; JLIMIT= 1; SLIMIT= 16 

The following example of a :SH0WJ0B command sequence illustrates an override of the default 
characteristics of list file with the :FILE command, and shows the output produced with the new list file 
characteristics: 

: FILE A;REC=40,1,F,ASCII;NOCCTL 

: SH0WJ0B;»A 

: SAVE A 

: FC0PY FROM=A;TO= 

HP32212A.3.17 FILE COPIER (C) HEWLETT-PACKARD CO. 1982 

MON, MAY 7, 1985, 7:54 AM 



JOBNW 


1 STATE IPRI 


JIN JLIST 


INTRODUCED JOB NAME 


#S46 


EXEC 




20 20 


MON 


7:14A OPERATOR. SYS 


#S45 


EXEC 




47 47 


MON 


6:37A MAC. PUBS 


#S47 


EXEC 




10S LP 


MON 


7:26A SUPPORT.DOC 


#S48 


EXEC 




102 102 


MON 


7: 28 A MAC. TECH 


#J19 


EXEC 




28 28 


MON 


6:41A JON.OSE 


#S49 


EXEC* 




34 34 


MON 


7:31A FLASH. G 


#J21 


EXEC 




10S LP 


MON 


7:15A DELIVER, MAIL. MAIL 


#J22 


EXEC 




10S LP 


MON 


7:14A RSPOOLJ,RSPOOL.SYS 


8 JOBS (DISPLAYED): 











INTRO 













WAIT; INCL 





DEFERRED 






8 


EXEC; INCL 


5 


SESSIONS 









SUSP 
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JOBFENCE= 6; JLIMIT= 4; SLIMIT= 50 
EOF FOUND IN FROMFILE AFTER RECORD 17 

18 RECORDS PROCESSED *** ERRORS 

END OF SUBSYSTEM 

a 

The :SHOWJOB command reports a job or session as being in EXEC* when it is initializing. After 
initialization is complete, the state will change to EXEC . The number shown in the EXEC state is the sum 
of the jobs and sessions in both EXEC and EXEC*. 
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:SHOWLOG 



Displays the number of system's current log file and the percentage of disc space used. 

SYNTAX 



:SHOWLOG 



PARAMETERS 

None. 

USE 

This command may be issued from Session, Job, in BREAK, or from a Program. It is not Breakable. The 
user must have System Supervisor or (OP) capability, or issue the command from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

The log file number, "xxxai', and percentage of file space used, "yy", is displayed in the format: 

LOG FILE LOG xxxx IS yy% FULL 

If the Logging System is disabled, MPE displays a "NO LOGGING' message. If logging is enabled but 
currently suspended due to an error, both messages appear. 

EXAMPLE 

To display the current log file status, enter: 
: SHOWLOG 
LOG FILE LOG2075 IS 20% FULL 

ADDITIONAL DISCUSSION 

Refer to the discussion of system logging in "MPE LOGGING FACILITIES" in Section of the MPE V 
System Operator and Resource Management Reference Manual (32033-90005). 
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SHOWLOGSTATUS 



Displays status information about currently opened user logging files assigned to a logging identifier. 



SYNTAX 



: SHOWLOGSTATUS [logid] 



PARAMETERS 

logid 



Displays the logging identifier created by the : GETLOG command. Default 
is that the status of all logging identifiers is displayed. 



USE 

This command may be issued from a Session, Job, or in BREAK. It may not be issued from a Program. It 
is not Breakable. 



OPERATION 

This command lists the status of currently running logging processes as shown in the example below. To 
display the status of all open log files enter: 



: SHOWLOGSTATUS 



LOGID 

DUMMY LOG 

TAPELOG 

DISCLOG 



CHANGE AUTO USERS STATE CUR-RECS MAX-REC %USED CUR-SET 

NO NO 4 INACTIVE 100 1000 ^0% 1 

YES 1 INACTIVE 5738 1 

YES YES 2 INACTIVE 500 1000 50?. 2 



COLUMN 

LOGID 
CHANGE 

AUTO 

USERS 



MEANING 

The name of the logging process. 

Whether the : CHANGE LOG command is permitted (whether the name of the 
first logging file ends in "001". 

Whether an automatic CHANGELOG has been enabled (whether the AUTO 
parameter has been specified for the : ALTLOG or : GETLOG command). 

The number of users accessing the logging file. 
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STAT E ACTIVE, INACTIVE, INITIALIZING, or RECOVERING. INACTIVE is 

displayed when a process is waiting for information from user processes that 
involve intrinsics. INITIALIZING starts the log process. RECOVERING is 
displayed immediately after a WARMSTART recovery. 

CUR-RECS The number of records in the log file. 

MAX-REC The maximum number of records permitted. 

%USED The percentage of the maximum used. 

CUR-SET The current set number. 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32002-90005) 
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:SHOWME 



Reports job/session status. 

SYNTAX 



: SHOWME 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 

OPERATION 

To display the status of the current job/session enter: 

: SHOWME 

USER: #S485,MGR.DSUSER,PUB (NOT IN BREAK) 

RELEASE: G.03.04 MPE V HP32033G.03.04 VERSION G.03.04 

CURRENT: MON, AUG 11, 1986, 11:09 AM 

LOGON: MON, AUG 11, 1986, 11:08 AM 

CPU SECONDS: 3 CONNECT MINUTES: 1 

$STDIN LDEV: 88 $STDLIST LDEV: 88 

(WELCOME TO SYS1) ** Local system's welcome message ** 

The : SHOWME command reports information pertaining to your job or session. Using the example above, 
the following information is given: 

ITEM MEANING 

#S485 This is the session number. It may also be a job number. 

(NOT IN BREAK) An "(IN PROGRAM)", "(IN BREAK)", or "(NOT IN BREAK)" message to 

indicate whether : SHOWME was executed programmatically, in BREAK, or 
directly from the MPE command. 

HP32033G. 00. 00 This is user defined version of the software that you are running. You can 

modify this number by using the rSYSDUMP command. In this example the 
"G" is the user defined version, the "03" the user defined update number, and 
the "04" the user defined fix number. 
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(BASE G.02.B0) 

CURRENT 

LOGON 

CPU SECONDS 



This number is the base MPE version, update, fix numbers. It is the official 
Hewlett-Packard version number of the operating system software and 
cannot be modified by :SYSDUMP. 

Shows the current time and date. 

Shows the logon time. 

Shows the Central Processor Time (CPU) used by this job/session. 



NOTE 



: SHOWME calculates CPU usage by adding the local CPU 
usage of the current process to the accumulated total of 
all terminated processes. The CPU usage listed for a 
programmatic : SHOWME, therefore, would rarely agree 
with that for a : SHOWME executed during BREAK. 



CONNECT MINUTES 
$STDIN LDEV 
$STDLIST LDEV 
(WELCOME TO SYS1) 



The amount of time job/session has been connected. 

The logical device number of the job or session's standard input device. 

The standard list device number. 

Shows the current welcome message, if the System Operator has entered 
one. 
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Displays the status of output devicefiles. 



:SHOWOUT 



Syntax 



:SHOWOUT [ 



{STATUS 
{SP 



{item[iitem]M . . .]]} 



PARAMETERS 

§Qnnn 



STATUS 



SP 



item 



Identifies a particular output devicefile for which information is to be 
displayed. The information is displayed in Type I format, described under 
"OPERATION". Default is a display of status information for all output 
devicefiles used by the logon job or session. 

Summarizes the status information for all current output devicefiles. The 
information is displayed in Type II format, described under "OPERATION". 
Default is a display of status information for all output devicefiles used by 
the logon job or session. 

Displays the status information for currently spooled output devicefiles 
associated with the logon job or session. The information is displayed in 
Type I followed by Type II format, described under "OPERATION". 
Default is a display of status the information for all output devicefiles used 
by the logon job or session. 

Displays the status of all current output devicefiles as identified. If 
information for only one devicefile is displayed, output is in Type I format; 
if information for more than one devicefile is displayed, output is in Type I 
followed by Type II format. Refer to "OPERATION".) The syntax appears 
on the next page. 
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Syntax for Item 



[DEV= 



{Idea 
{classname 



,3 



{€s 

[JOB={€ 

{[*]Jnnn 
{[t]Snnn 



{ACTIVE 
{OPENED 
{ LOCKED 



{READY 



UN] 



Parameters for Item 



Idev or 
classname 



JOB= 



ACTIVE, OPENED, 
READY, or LOCKED 



Displays the status of output devicefiles. The Idev parameter displays the 
files residing on the device identified by the logical device number. The 
classname parameter displays the status of the output devicefiles residing 
on all devices in a class name. 

Displays the status of output devicefiles using one of the following options. 

6J Displays the status of output devicefiles for all jobs. 

€S Displays the status of output devicefiles for all sessions. 

% Displays the output devicefiles for all jobs and sessions. 

[#] Jnnn Displays all output devicefiles for specified job. 

[#]Snnn Displays the status of all output devicefiles for a specified 
session. 

Displays status of all output files in a specified state. An ACTIVE file is 
one that is currently being produced on your printer, plotter, or punch card. 
Only one output spoolfile can be ACTIVE at any one time. OPENED files 
are those being accessed by a program. A spoolfile will be OPENED when a 
spooler process is writing the file to disc; during that time, however, the file 
is not ready to be printed, plotted or punched. READY files are completely 
spooled and ready to be output. A LOCKED file is READY but cannot be 
accessed until the system relinquishes it exclusive use of the file. 
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READY files may include one of the following: 

N Displays the status of nondeferred READY devicefiles. 

D Displays the status of deferred READY devicefiles. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution). 

OPERATION 

This command displays the status information for one or more currently defined output devicefiles. The 
information reflects the status at the time the command is entered and always appears on the standard list 
device. Two types of spooling queues are maintained in MPE: one output queue for each logical device 
configured on the system, and one additional queue for all device classes. Within each queue, files are 
linked according to the following parameters and listed in descending order of importance: output priority, 
device class, and rank. If the priorities are equal, the spooler alternates between queues. To list 
information about an individual output devicefile, you may specify its devicefile identifier (DFID) in the 
rSHOWOUT command: 



: SHOWOUT #011470 

DEV/CL DFID JOBNUM 
EPOC #011470 #J242 

OUTFENCE = 6 



FNAME STATE FRM SPACE RANK PRI #C 
$STDLIST READY 36 D 1 1 



COLUMN 

DEV/CL 

DFID 

JOBNUM 

FNAME 
STATE 



MEANING 

Logical device number or device class name of the device. 

Devicefile identification, in the form #Onnn. 

The job/session number (jsnum) of job/session using the devicefile if not 
used for READY or ACTIVE data. Otherwise, the job/session name 
appears online following standard device information. 

Filename assigned to devicefile. 

The status, indicated by one of the following subparameters: 



ACTIVE 



The spooled devicefile on disc is actually being written 
to a printer, plotter, or card punch. 
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LOCKED READY, but the system has exclusive access to the file. 

OPENED The devicefile on disc is being accessed by a program. If 

the devicefile is spooled, a program is currently writing 
to the disc. 

READY The spooled devicefile on disc is ready for output. 

FRM The forms message indicator (the letter "F") appears only if a forms 

alignment message applies to this devicefile. 

SPACE The approximate disc space currently used in sectors. This applies only to 

spooled output devicefiles. 

RANK The ranking of the file: its order in the system with respect to other files of 

the same output priority and classname or Idev. A time stamp activated by 
the FCLOSE command determines the file's rank. 

A "D" following "RANK" indicates a deferred file. This applies only to 
spooled devicefiles. A file can be deferred if its priority is less than or 
equal to system outfence or to the outfence of a specific device. 

PR I The output priority requested by user or as adjusted by the System Operator 

for spooled devicefiles only. A priority of 1 is lowest, and 1 3 is highest. 

#C Number of copies needed, for spooled devicefiles only. 

The output may appear in two possible formats or in a combination of the two formats: 

Type I: 

DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 

45 #032 #S16 $STDLIST OPENED 

OUTFENCE=6 



Type II: 



19 FILES 

ACTIVE 

2 READY; INCLUDING 2 SPOOFLES, 2 DEFERRED 
17 OPENED; INCLUDING 1 SPOOFLES 

LOCKED; INCLUDING SPOOFLES 

3 SPOOFLES: 1572 SECTORS 
OUTFENCE = 6 

OUTFENCE = 2 FOR LDEV 13 ** LDEV 1 3 has been assigned an outfence of 2 ** 
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EXAMPLES 

To display the total number of output devicefiles currently existing, the number of those that are spooled, 
and the states that they are in, enter: 

; SHOWOUT STATUS 
11 FILES: 

1 ACTIVE 

1 READY; INCL 1 SPOOFLES, DEFERRED 

9 OPENED; INCL 1 SPOOFLES 

LOCKED; INCL SPOOFLES 

3 SPOOFLES: 7212 SECTORS 
OUTFENCE= 2 



You can also request information about a specific output devicefile, device number or device class name of 
the device for which the file is destined in the : SHOWOUT command: 

: SHOWOUT DEV=43 

DEV/CL DFID JOBNUM FNAME STATE FRM SPACE RANK PRI #C 
43 #089 #S37 $STDLIST OPENED 

OUTFENCE= 2 
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SHOWQ 



Displays process scheduling data and the contents of each subqueue. 

SYNTAX 



: SHOWQ 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK. It may not be issued from a Program. It is 
Breakable, (aborts execution). It requires System Supervisor (OP) capability. 

OPERATION 

The process scheduling and subqueue information is displayed in three major columns: "DORMANT", 
"WAITING", and "RUNNING". RUNNING processes are these that currently require the CPU in order to 
continue, or that will require it in the immediate future. CPU time is automatically allocated to the 
highest -priority process that is ready to run. 

The processes listed in "DORMANT" and "WAITING" columns are waiting on longer-term events. 
DORMANT processes must wait a shorter amount of time than WAITING processes, for example, until a 
code segment moves into memory. WAITING processes wait for a longer event, such as an I/O completion. 
They will contend for the CPU once those events have occurred. 

On occasion, a process will appear in more than one column. This indicates that the process was being 
moved one column to the right when you executed of : SHOWQ. 

Below is a sample of the output listing produced by the : SHOWQ command. The symbols that may appear 
in such a listing are explained in the remainder of the discussion. 



DORMANT 




WAITING 


RUNNING 


Q PIN 


JOBNUM 


Q PIN JOBNUM 


Q PIN JOBNUM 


L 1 






C M163 #S263 


L 2 






C U215 #S256 


L 3 








L 4 








D U29 


#J30 






C M37 


#S234 






C M55 


#S248 
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Each entry in the three columns displays the following information for a single process: 
{ L } 

< C > I M J ntn r #Jnnn 1 

{ D } [ U ] ptn l #Snnn J 
{ E } 

Where: 

L a linearly scheduled process on the AS, BS, or master queue. 

C a circularly scheduled process on the CS queue. 

D a circularly scheduled process on the DS queue. 

E a circularly scheduled process on the ES queue. 

M a job main process. 

U a user process. 

pin the Process Identification Number for this process. 

J nnn the process executing in a batch job. 

S nnn the process executing from a session. 

The Process Identification Number (PIN) may appear with or without an M or U label. Processes without 
an M or U label are system processes. 

In addition, :SHOWQ prints the scheduling parameters currently in effect along with the minimum 
memory manager algorithm cycle value (minclockcycle). 

CQ MINQUANTUM=0, MAXQUANTUM=300 , BASEPRI=152, LIMITPRI=200 
DQ MINQUANTUM=1000, MAXQUANTUM=1000, BASEPRI=202, LIMITPRI=238 
EQ MINQUANTUM=1000, MAXQUANTUM=1000, BASEPRI=153, LIMITPRI=154 
MINIMUM CLOCK CYCLE=1000 

EXAMPLE 

To display the queues of processes within MPE, enter: 
t SHOWQ 

The system will display a listing of DORMANT, WAITING, and RUNNING processes similar to the one 
explained in the preceding "OPERATION" section. 
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:SHOWTIME 

Prints current time and date. 

SYNTAX 



: SHOWTIME 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

Prints current time and date, as indicated by system clock. 

EXAMPLE 

To display the time and date, enter: 

: SHOWTIME 

MON, JUL 24, 1985, 8:47 AM 
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=SHUTDOWN 

Initiates a shutdown of MPE. 

SYNTAX 



=SHUTDOWN 



PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK. It may not be issued from a Program. It is 
not Breakable. It can be issued only at the Console. 

OPERATION 

The =SHUTDOWN command performs an implicit =LOGOFF of all sessions, including the session logged at the 
system console. All system processes are stopped in an orderly fashion. This includes the completion of all 
pending system activity and any processing necessary to ensure that the integrity of all system tables and 
directories is maintained. Once these procedures are complete, "SHUT' is displayed on the console, the CPU 
halts, and console interrupt (A ) is ineffective. 

Device configuration changes that were made after the preceding load (:UP, :DOWN, :GIVE, :TAKE, 
: ACCEPT, : REFUSE and spooling commands) will not be retained. Configuration changes made during 
cold load are permanently recorded and retained until the next tape cold load. Newly assigned or released 
global Resource Identification Numbers (RINs) are permanently recorded. 

All communication lines must be closed before issuing a =SHUTDOWN command. Otherwise, a manual halt 
of the system may be necessary. Note that data will be lost if a transmission is in progress when the halt 
is performed. Also, if DSN/DS lines were left open before issuing the ^SHUTDOWN, lines to the remote 
system will remain open and any remote sessions will be effectively "hung". In this case, the remote 
system's Operator may need to issue : ABORTIO commands for the hung sessions and then abort the sessions 
themselves. 

Spooled devices will stop operation immediately upon receiving a =SHUTDOWN command. A 
WARMSTART will keep spoolfiles so that they may be printed when the system is returned online. 
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EXAMPLE 

To shut the system down, first issue a warning to all users to allow them time to log off, and then execute 
=SHUTDOWN as shown below: 

: WARN e;SYSTEM WILL SHUTDOWN IN FIVE MINUTES. PLS LOG OFF. 

A c ** Press A and CNTL simultaneously ** 

= SHUTDOWN 

1 : 49/#S40/25/LOGOFF 

10:49/20/ALL JOBS LOGGED-OFF 



2-356 



:SHUTQ 



Closes the spool queue for the specified logical device or device class. This command is available on the 
G. 00. 00 and later releases of the operating system. 

SYNTAX 



{deOclass} 



PARAMETERS 

IdeO The logical device number of the spooled device. 

deOclass The device class name of the spooled device. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a program. It is not Breakable. It 
may be issued only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

:SHUTQ closes the spool queue for a logical device or device class configured in the system. The spooler 
process, however, does not need to be running for the device. If the spooler process is running, it is 
unaffected by shutting the queue. 

This command also serves as an option to the :STARTSPOOL command, which is also documented in this 
section. 

EXAMPLE 

To shut the queue for device class LP, enter: 
:SHUTQ LP 
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:SPEED 



Changes the operating speed of the terminal. 

SYNTAX 




PARAMETERS 

newinspeed The new input speed in characters-per-second (CPS). For Series 

39/40//42/44/58/64/68/70 the speed must be 15, 60, 120, 240, 480, or 
960. Series 39/40/42/44/48 also supports 10 CPS. If you are using the 
ATP driver, the speed 1020 is also supported. The newinspeed must be the 
same as newout speed. 

neWoutspeed The new output speed in characters-per-second. For Series 

39/40/42/44/58/64/68/70 the speed must be 15, 60, 120, 480, or 960. 
Series 39/40/42/44/48 also supports 10 CPS. If you are using the ATP 
driver, the speed 1 020 is also supported. The newout speed must be the 
same as newinspeed. 

USE 

This command may be issued from a Session, but not from a Job. It may be issued in BREAK or from a 
Program. It is not Breakable. 

OPERATION 

MPE automatically senses the input/output speed of a terminal when you logon at that terminal. If your 
terminal has speed adjustment controls, you can change the input and output speeds after logon with the 
: SPEED command. This command is not valid for terminals that operate at only one speed. 

When the command is entered, MPE displays the following message at the old output speed: 

CHANCE SPEED AND INPUT "MPE": 

Manually change the speed control on the terminal and verify the new speed by entering: 



MPE [RETURN! 

If the characters "MPE" cannot be verified, the system assumes that the terminal is to continue at the old 
speed. (To continue, you must reset the terminal control to the old speed.) Note that on Hewlett-Packard 
terminals the "Baud Rate" is Characters Per Second (CPS) multiplied by 1 0. When you select the Baud 
Rate at which you choose to operate you must, therefore, divide the rate by 1 0, and enter that value with 
the : SPEED command. 
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You can also change the terminal speed programmatically by using the FCONTROL intrinsic. Refer to the 
MPE V Intrinsics Reference Manual (32033-90007). 

Refer to Appendix A "TERMINALS SUPPORTED BY MPE V" for a list of the terminal types and the 
speeds that they support. 

EXAMPLES 

To change the input and output speeds to 240 CPS (2400 baud), enter 

: SPEED 240,240 

CHANGE SPEED AND INPUT "MPE": 
{ 

Manually change the speed and type in MPE. The "{" is a random character. 

{ MPE IRETURN1 

ADDITIONAL DISCUSSION 

Fundamental Communications Handbook (5957-4634) 
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:SPL 



Compiles an SPL program. SPL is not part of the HP 3000 Fundamental Operating Software and must be 
purchased separately. 



SYNTAX 



:SPL [text file] Musi file] [, [list file] [Amaster file] \mneu)file] ] ] ] 
\§mFO=quotedstring] 



PARAMETERS 

text file 

uslfile 



listfile 
masterfile 

neb) file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. The formal file designator is 
SPLTEXT. Default is $STDIN. 

Actual file designator of the User Subprogram Library (USL) file to which 
the object code is written. This can be any binary output file created with a 
file code of USL or 1024.. Its formal file designator is SPLUSL. If the 
uslfile parameter is omitted, the object code is saved to the temporary file 
$0LDPASS. If the uslfile parameter is entered, it indicates that the file was 
created in one of four ways: 

• By using the MPE : SAVE command to save the default USL file created 
during a previous compilation. 

• By building the USL with the MPE Segmenter -BUILDUSL command. 
Refer to the MPE Segmenter Reference Manual (30000-9001 1). 

• By creating a new USL file with the MPE : BUILD command and 
specifying a file code of USL or 1 024. 

• By having the statement $C0NTROL US LI NIT in your program. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. The formal file designator is SPLLIST. 
Default is $STDLIST. 

Actual file designator of the master file with which textfile is merged to 
produce a composite source. This can be any ASCII input file. The formal 
file designator is SPLMAST. Default is that the master file is not read; input 
is read from textfile, or from $STDIN if textfile is not specified. 

Actual file designator of the file created by merging textfile and masterfile. 
This can be any ASCII output file. Formal designator is SPLNEW. Default 
is that no file is written. 
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NOTE 

The formal file designators used in this command (SPLTEXT, 
SPLUSL, SPLLIST, SPLMAST, and SPLNEW) cannot be 
backreferenced as actual file designators in the command 
parameter list. For further information, refer to the 
"Implicit :FILE Commands For Subsystems" discussion of the 
:FILE command. 

quotedstring A sequence of ASCII characters bounded by a pair of single quotation 

marks (apostrophes) or by double quotations marks. If you want a 
quotation to appear within quotedstring, the quotation and its quotation 
marks must also be bounded by quotation marks. For example, to insert 
"and" into a quotedstring, it must appear as ""and"". Similarly, 'and' must 
appear as "and". The maximum length of the string, including delimiters, is 
255 characters. Refer to "OPERATION". 

For SPL to recognize quotedstring, a dollar sign ($) must follow the 
quotation marks at the beginning of the quotedstring. This feature is used 
to specify compiler options which will appear at the beginning of the source 
listing. For more information, refer to the : RUN command in this section. 

USE 

This command may be issued from a Session or a Job, but not in BREAK or from a Program. It is 
Breakable (suspends execution). 

OPERATION 

This command compiles an SPL program into a User Subprogram Library (USL) file on disc. If textfile is 
not specified, MPE expects the source program to be entered from your standard input device. If listfile is 
not specified, the program output will be sent to your standard list device. 

EXAMPLES 

The following example compiles an SPL program entered from your standard input device into an object 
program in the USL file $OLDPASS, and writes the listing to your standard list device: 

: SPL 

The next example compiles an SPL program contained into the disc file SOURCE and stores the object code 
into the USL file OBJECT. The program listing will be sent to the disc file LISTFL: 

: SPL SOURCE .OBJECT, LISTFL 
; SAVE OBJECT 

ADDITIONAL DISCUSSION 

Systems Programming Language Reference Manual (30000-90024) 
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:SPLGO 



Compiles, prepares, and executes an SPL program. SPL is not part of the HP 3000 Fundamental 
Operating Software and must be purchased separately. 



SYNTAX 



:SPLGO [textfile] [^[listfile] [§_ [masterfile] [ % neafile]]] 
[MlHFO=quotedstring] 



PARAMETERS 

textfile 
list file 
masterfile 



new file 



Actual file designator of the input file from which the source program is 
read. This can be any ASCII input file. The formal file designator is 
SPLTEXT. Default is $STDIN. 

Actual file designator of the file to which the program listing is written. 
This can be any ASCII output file. The formal file designator is SPL LIST. 
Default is $STDLIST. 

Actual file designator of the master file that is merged against textfile to 
produce a composite source. This can be any ASCII input file. Formal file 
designator is SPLMAST. Default is that the master file is not read; input is 
read from textfile, or from $STDIN if textfile is not specified. If two files 
being merged have identical line numbers, the lines from textfile or from 
$STDIN will overwrite those in masterfile. 

Actual file designator of the file produced by merging textfile and 
masterfile. This can be any ASCII output file. The formal file designator 
is SPLNEW. Default is that no file is written. 



NOTE 



The formal file designators used in this command (SPLTEXT, 
SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information, refer to the "Implicit :FILE 
Commands For Subsystems" discussion of the :FILE 
command. 



quotedstring 



A sequence of ASCII characters bounded by a pair of single quotation 
marks (apostrophes) or by double quotation marks. If you want a quotation 
to appear within quotedstring, the quotation and its quotation marks must 
also be bounded by quotation marks. For example, to insert "and" into a 
quotedstring, it must appear as ""and"". Similarly, 'and' must appear as 
"and". The maximum length of the string, including delimiters, is 255 
characters. 
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For SPL to recognize quotedstring, a dollar sign ($) must follow the 
quotation marks at the beginning of the quotedstring. This feature is used 
to specify compiler options which will appear in front of the source listing. 
For more information, refer to the : RUN command in this section. 



USE 

This command may be issued from a Session or a Job, but not in BREAK or from a Program. It is 
Breakable (suspends execution). 



OPERATION 

This command compiles, prepares, and executes an SPL program. If textfUe is omitted, MPE expects input 
from your standard input device. This command creates a temporary User Subprogram Library (USL) file 
($NEWPASS) that you cannot access, and a temporary program file that you can access under the name 
$OLDPASS. For more information, refer to 'System Defined Files", Section I of this manual. 

EXAMPLES 

To compile, prepare, and execute an SPL program entered from your standard input device, and have the 
program listing sent to your standard list device, enter 

; SPLOO 

To compile, prepare, and execute an SPL program read from the disc file SOURCE and send the resulting 
program listing to the disc file LISTFL, enter: 

: SPLGO SOURCE, LISTFL 

ADDITIONAL DISCUSSION 

Systems Programming Language Reference Manual (30000-90024) 
MPE Segmenter Reference Manual (30000-9001 1) 



2-363 



rSPLPREP 



Compiles and prepares an SPL program. SPL is not part of the HP 3000 Fundamental Operating Software 
and must be purchased separately. 



SYNTAX 



rSPLPREP [textfile] [U[prog file] [^[listfile] [§ [master file] lineafile]]]] 
[|l HFO=quotedst ring ] 



PARAMETERS 

text file 

prog file 



list file 
masterfile 



new file 



Actual file designator of the input file from which source program is read. 
This can be any ASCII input file. Formal file designator is SPLTEXT. 
Default is $STDIN. 

Actual file designator of the program file to which the prepared program 
segments are written. You will get the best results by omitting the progfile 
parameter. When you omit progfile, the Segmenter creates the program 
file, which will reside in the temporary file domain as $OLDPASS. If you do 
create your own program file, you must do so in one of two ways: 

• By using the MPE : BUILD command, specifying a file code of 1029 or 
PROG, and a numextents value of 1. This file is then used by the : PREP 
command. 

• By specifying a nonexistent file in the progfile parameter, in which 
case a job/session temporary file of the correct size and type is created. 

Actual file designator of the file to which program listing is written. This 
can be any ASCII output file. Formal designator is SPL LI ST. Default is 
$STDLIST. 

Actual file designator of the master file that is merged against textfile to 
produce composite source. This can be any ASCII input file. The formal 
file designator is SPLMAST. Default is that the master file is not read; input 
is read from textfile, or from $STDIN if textfile is not specified. If two file 
being merged have identical line numbers, the lines form textfile or from 
$STDI N will overwrite those in masterfile. 

Actual file designator of the file produced by merging textfile and 
masterfile. This can be any ASCII output file. The formal file designator 
is SPLNEW. Default is that no file written. 
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NOTE 

The formal file designators used in this command (SPLTEXT, 
SPLLIST, SPLMAST, and SPLNEW) cannot be backreferenced 
as actual file designators in the command parameter list. 
For further information refer to the "Implicit :FILE 
Commands For Subsystems" section of the : FILE command. 

quotedstring A sequence of ASCII characters bounded by a pair of single quotation 

marks (apostrophes) or by double quotation marks. If you want a quotation 
to appear within quotedstring, the quotation and its quotation marks must 
also be bounded by quotation marks. For example, to insert "and" into a 
quotedstring, it must appear as ""and 1 "'. Similarly, 'and' must appear as 
"and". The maximum length of the string, including delimiters, is 255 
characters. Refer to "OPERATION". 

For SPL to recognize quotedstring, a dollar sign ($) must follow the 
quotation marks at the beginning of the quotedstring. This feature is used 
to specify compiler options which will appear at the beginning of the source 
listing. For more information, refer to the : RUN command in this section. 



USE 

This command may be issued from a Session or a Job, but not in BREAK or from a Program. It is 
Breakable (suspends execution). 

OPERATION 

Compiles and prepares an SPL program into a program file on disc. If textfile is not specified, MPE 
expects you to enter your source program from your standard input device. If you do not specify listfile, 
your program output will be sent to your standard list device. 

The User Subprogram Library (USL) file created during compilation, $OLDPASS, is a temporary file passed 
directly to the Segmenter. It can be accessed only if you do not use the default for progfile. This is 
because the Segmenter also uses $OLDPASS to store the prepared program segments, overwriting the USL 
file of the same name. 

EXAMPLES 

To compile and prepare an SPL program entered from your standard input device and send the output to 
your standard list device, enter: 

:SPLPREP 
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The following example compiles and prepares an SPL source program from the disc file SFILE into the 
program file MY PROG. The program listing will be sent to your standard list device: 

t SPLPREP SFILE, MVPROO 

In the next example, the first first positional parameter is omitted. This indicates to MPE that you intend 
to enter the source text from your standard input device. The object code will be stored in the default 
USL file $OLDPASS, and the prepared program segments will be stored in FILEZ. OLDPASS is then saved 
in the permanent file domain under the new name NUSL. 

•. SPLPREP, FILEZ 
; SAVE $OLDPASS, NUSL 

ADDITIONAL DISCUSSION 

System Programming Language Reference Manual (30000-90024) 
MPE Segmenter Reference Manual (30000-9001 1) 
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:STARTCACHE 



Enables caching on a single disc. Disc caching software is not included with the Fundamental Operating 
Software and must be purchased separately. 

SYNTAX 



:STARTCACHE Idet) 



PARAMETERS 

Ideo The logical device number of the disc to be used for caching. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
requires System Supervisor (OP) or System Manager (SM) capability. 

OPERATION 

The System Supervisor uses this command to enable caching on a single disc. When the system is first 
started, caching is disabled, by default. Each disc to be cached requires a separate invocation of the 
command. 

EXAMPLE 

To enable caching on Idev 3, enter: 

; STARTCACHE 3 

CACHING STARTED ON LDEV 3. 



NOTE 



If caching is not installed on your system, an error message 
will be displayed: 

CIERR 4417 DISC CACHING NOT ENABLED ON 
THIS SYSTEM 
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:STARTSESS 



Creates a session on the specified device, provided that the command's user has Programmatic Sessions (PS) 
capability. (G. 1 . 00 or later releases) 

SYNTAX 



:STARTSESS ldeo[sessionnatn^]user[§userpass] .acct \§acctpass] 
\Mgroup]Mgrouppass\ ] 



[|TIME=cp«secs ] 
(BS> 

r-PRi= <cs} i 

{ES} 



,(§INPRI=inputpriority} , 

l {|1|hipri } J 

[pOWAIT] 



PARAMETERS 

Ideo 



The logical device number of the target terminal. This terminal must be a 
real physical device and cannot be a virtual terminal or a DS pseudo 
terminal. The terminal must be configured as TYPE 16 and as SUBTYPE 
or 4. 



NOTE 



All required passwords must be specified in the 
command invocation; STARTSESS will not prompt the 
caller or the Idev for passwords. Omitting a missing 
password where one is required will cause the command 
to fail. 



sessionname 



user 



Arbitrary name used in conjunction with the user and acct parameters to 
form a fully qualified session identity. The name may contain from one to 
eight alphanumeric characters, beginning with an alphabetic character. 
Default is that no session name is assigned. 

User name, established by the Account Manager, that allows you to logon 
under this account. The name may contain from one to eight alphanumeric 
characters, beginning with an alphabetic character. 
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userpass 



acct 



acctpass 



group 



grouppass 



termtype or 
termname 



User password, optionally assigned by the Account Manager. The password 
may contain from one to eight alphanumeric characters, beginning with an 
alphabetic character. 

Account name established by the System Manager. The name may contain 
from one to eight alphanumeric characters, beginning with an alphabetic 
character. A period (.) must precede the acct parameter. 

Account password, optionally assigned by the System Manager. The 
password may contain from one to eight alphanumeric characters, 
beginning with an alphabetic character. A slash (/) must precede the 
acctpass parameter. 

Group name to be used for the local file domain and the CPU time charges 
established by the Account Manager. The name may contain from one to 
eight alphanumeric characters, beginning with an alphabetic character. 
Default is the specified users home group if you are assigned one by the 
Account Manager. The parameter is required if a home group is not 
assigned. 

The grouppass parameter is not needed when the user logs on under the 
user's home group, even if a password has been established. The grouppass 
is needed when the user logs on under any other group for which a 
password has been established. A slash (/) must precede the parameter 
grouppass. 

Determines terminal -type characteristics. The value of the termtype 
parameter determines the type of terminal used for input. MPE uses this 
parameter to determine device -dependent characteristics such as delay 
factors for carriage returns. The value must be a number from to 22. 
The default value for termtype is assigned by the System Supervisor during 
system configuration. This parameter is required to ensure correct listings 
if your terminal is not the default termtype. 

The termname parameter is the name of the file containing the desired 
terminal -type characteristics. The file must not have a lockword or reside 
on a Private Volume. 

Users of the Workstation Configurator are allowed to create terminal -type 
files. The proper and efficient operation of a specific device by a 
user-created terminal-type is the responsibility of the user. The 
Workstation Configurator utility allows the user to specify the following 
characteristics of the terminal: data flow control, block mode, read trigger, 
special characteristics, echo, line feed, parity, and printer control. 

If group and/or account names are omitted, the proposed logon group 
and/or account name is substituted. For further information on the 
terminal -type characteristics, refer to the Communications Handbook 
(30000-90105) and the Workstation Configurator Reference Manual 
(30239-90001). Refer also to Appendix A, "Terminals Supported by MPE", 
in Section III of this manual. 
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cpusecs 



Maximum CPU time that a session must use, entered in seconds. When the 
limit is reached, the session is aborted. It must be a value from 1 to 32767, 
provided that it does not exceed any limit imposed by the System or 
Account Manager. To specify no limit, enter a question mark (?), or UN LI M, 
or omit the parameter. Default is no limit. BS, CS, DS, or ES The 
execution priority queue that the Command Interpreter uses for your 
session, and also the default priority for all programs executed within the 
session. BS is highest priority, ES is lowest. If you specify a priority that 
exceeds the highest permitted for your account or username by the system, 
MPE assigns the highest priority possible below BS. DS and ES are intended 
primarily for batch jobs; their use for sessions is generally discouraged. 
Care should be used in assigning the BS queue because processes in this 
priority class must lock out other processes. For information on the 
guidelines for these priority queues, refer to the :TUNE command in this 
section. Default is CS. 



inputpriority or 
HIPRI 



Determines the input priority of the job or session. The inputpriority 
option is the relative input priority used in checking against access 
restrictions imposed by the job fence. The inputpriority option takes effect 
at logon time and must be from 1 (lowest priority) to 1 3 (highest priority). 
If you supply a value less than or equal to current job fence set by System 
Operator, session is denied access. Default is 8. 



The HIPRI option is used for two different purposes when logging on. It 
can be used to override the system job fence or it can be used to override 
the session limit. When using the HIPRI option to override the job fence, 
the system will first check to see if you have System Manager (SM) or 
System Operator (OP) capability. The user who has either of these 
capabilities, will be logged on and the INPRI will default to the system's job 
fence and execution limit. If you do not have either of these capabilities, 
the system will attempt to log you on using INPRI = 13 and will succeed if 
the job fence is 12 or less, and the session limit is not exceeded. In 
attempting to override the session limit (to logon after the maximum 
number of sessions set by the operator has been reached), you can specify 
HIPRI, but in this case you must have either SM or OP capability. The 
system will not override the the session limit automatically. Use of the 
HIPRI option without SM or OP capability causes the following warning to 
be displayed: 

MUST HAVE 'SM' OR 'OP' CAP. TO SPECIFY HIPRI, 
MAXIMUM INPRI OF 13 IS USED (CIWARN 1460) 



NOWAIT 



Request that the session starts executing immediately without waiting for a 
tRETURNl on the terminal. If this parameter is specified and the target 
terminal is the System Console, System Manager (SM) capability is required. 



2-370 



USE 

This command is available from a session, job, in BRE^K, or from a Program. It is not Breakable. It 
requires Programmatic Sessions (PS) capability. 

OPERATION 

Use this command to create a session at any terminal on the system. The effect is the same logging on at 
the target terminal. 



NOTE 



1. The target terminal must be available; no other user 
must be logged on, and the terminal must be turned on. 

2. No speed sensing will be done for the target terminal, so 
it must be set at the configured baud rate. 

3. When the session is created, nothing will be printed to 
the target terminal until its carriage return key is 
pressed unless NOWAIT was specified. 



PASSWORDS 

If you are issuing :STARTSESS for an account, user, or group that has a password, you must provide that 
password when you issue the command. You can either embed the passwords required in the logon string 
using the slash mark (/) or MPE will prompt you for any required passwords. 

The password prompt will be similar to the one for the : HELLO command; MPE prompts you for the 
password, then turns off echoing so the password will not be printed. If you enter the password 
incorrectly, the prompt will reappear and you will have two more chances to enter the password correctly. 
After the third incorrect entry, the : STARTSESS command aborts. 

EXAMPLE 

To start a session named ALPHA, with the username MAC, accountname TECHPUBS, groupname XGROUP, 
grouppass XPASS, on ldev 21, enter: 

:STARTSESS 21 ;ALPHA,MAC. TECHPUBS, XGROUP/XPASS 
PROGRAMMATIC LOGON FOR SESSION #S7258 
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:STARTSPOOL 



Initiates the spooler process for a device. 



Syntax 



: STARTS POOL 



rOdevUSHUTQ]}, 
{devclass } 



PARAMETERS 

Idev 

devclass 

SHUTQ 



The logical device number of a spooled device. When the spooler gains 
control of the specified device, it controls spooling to it as well as to all 
device classes which reference the device. 

The device class specified in the I/O configuration. Only this device class 
becomes spooled; it will not affect other device classes or any devices in the 
class. 

The spooler will print files waiting in the queue for device Idev, but 
prevents the creation of new spoolfiles. The SHUTQ parameter is valid for 
Idev only. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only at the Console. * 

* Unless distributed to users with the : ALLOW or ASSOCIATE commands. 

OPERATION 

To start the spooling process for a specified device, and for any and all device classes associated with it, 
issue the :STARTSP0OL command with the Idev parameter. When devclass is used with :STARTSP0OL, 
only the specified device class will be controlled by the spooler. The logical device itself will not be 
controlled, unless a : STARTS POOL has also been issued for the corresponding Idev. 

The HP 2680A and HP 2688 Laser Printer operates only as a spooled device. If spooling is enabled only 
on the Laser Printer's Idev, and spooling stops as a result of an I/O error, no new spoolfiles will be created. 
To avoid this, issue the : STARTS POOL command twice for an HP 2680 Laser Printer: once for the 
devclass associated with the printer, and a second time for the Idev assigned to it. 
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NOTE 

If the Idev referenced in a : STARTS POOL command is an HP 
2894 card reader/punch, the following message will be 
generated on the system console: 

IS THIS AN INPUT OR OUTPUT SPOOLER 
(IN/OUT)? 

You must then enter the appropriate reply: "IN", if cards are 
to be read; "OUT", if cards are to be punched. 

EXAMPLES 

To start spooling all output to logical device 6 and all device classes that reference logical device 6, enter: 

: STARTS POOL 6 
To start spooling all output to device class LP, enter: 

: STARTSPOOL LP 

To start spooling on logical device 6 while preventing the creation of any new spoolf iles, enter: 
; STARTS POOL 6^SHUTQ 

ADDITIONAL DISCUSSION 

Refer to the discussion of "SPOOLING" in the MPE System Operation and Resource Reference Manual 
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:STOPCACHE 



Disables caching on a single disc. Disc caching software is not included in the Fundamental Operating 
Software, and must be purchased separately. 

SYNTAX 



:STOPCACHE IdeO 



PARAMETERS 

Idet) The logical device number of the disc for which you intend to disable 

caching. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
requires System Supervisor (OP) or System Manager (SM) capability. 

OPERATION 

The System Supervisor uses this command to disable caching on a single disc. If your system uses more 
than one disc for caching, each Idev must be disabled with a separate invocation of :STOPCACHE. 

EXAMPLE 

To disable caching on Idev 3, enter: 
:STOPCACHE 3 
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:STOPSPOOL 



Terminates spooling to a specified device or device class. 



Syntax 




PARAMETERS 

Ideo 



deoclass 



OPENQ 



The logical device number of a spooled device. The spooler process gives up 
ownership of the spooled device. If the OPENQ parameter is omitted the 
device becomes available only for non-spooled I/O. When a logical device 
is assigned to more than one device class, spooling may be restarted for a 
specific device class by issuing an explicit : STARTS POOL request for that 
class. 

The device class specified in system I/O configuration. Subsequent I/O 
directed to this device class will not take place to/from a spoolfile. I/O 
will go directly to/from a logical device if one is available within the 
device class. If none is available, the program will be unable to open the 
file. 

May be specified with the Idev parameter only. The spooler process will 
leave the queue OPEN , or will OPEN the queue if previously shut. Default 
is SHUTQ . 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable It 
may be issued only from the Console.* »ic*M,oie. « 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

You may use the :ST0PSP0OL command to stop spooling for a single logical device, or for all devices 
assigned a common device class. Using the devclass parameter in a rSTOPSPOOL command will shut the 

op^TSkulth SHUTQ 188 " Wh6n y ° U SPCCify ld6V ' h0WCVer ' y ° U may ShUt thC Sp0Oling QUeue ° r leave il 

When spooling is stopped for a particular device without using OPENQ, that device is conversationally 
referred to as "hot" (a "hot printer", for example). In this case, one job has exclusive access to that device 
preventing other programs from accessing it. 
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EXAMPLES 

To terminate spooling to logical device number 6 and cause the spooler process to relinquish control of 
that device, enter: 

: STOPS POOL 6 

Spooling will also terminate for any device class that references this device unless a : ST ARTS POOL has 
been issued for a specific device class. 

To stop directing output for device class LP to a spoolfile (provided a : STOPS POOL 6 has also been issued), 
enter: 

i STOPSPOOL LP 

To terminate spooling on device 6 and leave the queue open, enter: 

i STOPSPOOL 6;0PENQ 

ADDITIONAL DISCUSSION 

Refer to the discussion of "SPOOLING" in the MPE V System Operation and Resource Management 
Reference Manual (32033-90005). manual. 
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:STORE 



Copies disc files onto magnetic tape or serial disc. Use the : RESTORE command to copy files back to disc. 



SYNTAX 



:ST0RE .[{/£Zeset[-fileset][»fileset[-fileset]J[|...]}] 
[Oindirecifile }] 



{;* store file)] 
{; store file }] 



| SHOW [ =shotiparm [ ^showparmi ,...]]]] 
|FILES=ffwacf£Zes] 

*DATE[<< = "^ e >] 
* l {>=moddate} 1 

SONERR[or]-[<*JJ}l 
| PURGE] 

X PROGRESS [=#minutes] ] 

jjjSTORESET -tapelistspec] 

1 INTER [leave]] 

5COPYACD] 



PARAMETERS 

fileset 



Specifies the set of files to be stored. You must have READ access to files in 
order to store them. This positional parameter has the form: 

fi lename [ . groupname [ . ace t name] ] 

If you do not specify a group or account, MPE stores files in your logon group 
and account. The default file name is § which stores all files in the logon 
group. 

You can use the characters €, #, and ? as wildcard characters to refer to a 
group of files. The wildcard characters count toward the eight character 
limit for the user, group, account, and file names. The wildcard characters 
have the following meanings: 
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% 



Represents zero or more alphanumeric characters, Usee 
alone, % denotes "all members of the set" 



# Represents one digit 

? Represents one alphanumeric character 

You might use the wildcard characters as shown in the following examples: 
Stores all items beginning with the character "n" 
Stores all items ending with the character "n" 






Stores all items starting with the character "n" and ending 
with the character "x" 

n####### Stores all items starting with the character "n" followed b> 

seven digits 

?n@ Stores all items whose second character is "n" 

n? Stores all two-character items beginning with an "n" 

?n Stores all two-character items ending with an "n" 



-fileset 



! indirect file 



*storefile 



SHOW 



shotfparm 



Name of a file set or subset to be excluded. You can have only one excluded 
subset for each file set, and you cannot specify excluded subsets within 
excluded subsets. A negative sign must precede this parameter. 

An ASCII file containing parameters for the : STORE command. Any line of 
the indirect file may contain file sets and keywords. An exclamation poinl 
must precede this parameter. 

The name of a single tape or serial disc device file on which to store the files. 
It can be any magnetic tape or serial disc in the output set. Release E. 01. OC 
of MPE requires this parameter. In releases subsequent to G. 03. 00, use il 
only if you are storing files to a single device. (Use the STORESET option tc 
specify multiple backup devices.) Use a :FILE command to name the output 
file, and an asterisk to backreference that file in your : STORE command. 

Produces a list of all files stored. As each file is stored, STORE prints the 
following information on your terminal: filename, group name, account name 
logical device number, file size (in sectors), and file code. The STORE program 
also displays error messages on your terminal. If a particular file is not stored 
for any reason, you may elect to abort the store process. STORE sends the 
listing to $STDLIST (designator: SYSLIST) unless you issue a :FILE 
command to send listing to some other output device. If you do not use the 
SHOW parameter, STORE only lists the names of files not stored and the 
number of files stored and not stored. 

May be SHORT, LONG, DATES, SECURITY, or OFFLINE. You cannot specify 
both LONG and SHORT, but you can combine other parameters by separating 
them with commas. If you select neither SHORT or LONG, the default is 
SHORT if $STDLIST is less than 99 characters and LONG otherwise. 
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SHORT 



LONG 



Displays the file name, group name, account name, logical 
device number, sector address, reel number, and file size (in 
sectors) of all files stored. 

Displays the same information as SHORT and the file 
record size, file type, end-of-file, file record limit, 
blocking factor, extents allocated, and maximum extents of 
all files stored. 



DATES 



Displays the creation date, last access date, and last 
modification date of all files stored. 



SECURITY Displays the creator and file access matrix of all files 

stored. 



max files 



accdate or 
moddate 



ONERR[OR] 



OFFLINE Sends file listings to the system line printer as well as to 

your terminal. You can redirect the output from the 
system line printer to another output device with a :FILE 
command redefining the formal file designator OFFLINE. 

Maximum number of files to store. If it encounters more than the maximum 
number of files, STORE prints an error message and quits. The default is 
4,000. 

Stores only those files that have been accessed or that have not been modified 
since the date specified. Use accdate to store only files not accessed since a 
specific date. Use moddate to store only files modified on or after a specific 
date. If you do not specify a date, STORE will store all files in the specified 
file set. 

Specifies a tape error recovery mode. 



PURGE 
PROGRESS 

# minutes 

STORESET 
(G. 03. 00 and 
later releases) 



QUIT 
REDO 

Default: 



STORE terminates when it encounters a tape error. 

Instructs STORE to automatically recover from cartridge 
tape drive power failures (G. 02. B0 and later releases) and 
after all tape I/O errors. 

QUIT for labeled tapes. REDO for unlabeled tapes. 



Instructs STORE to purge files that are successfully stored. 

Instructs STORE to periodically display its progress as the percentage of the 
operation completed. 

Specifies the interval at which STORE prints progress messages. 

Describes multiple output devices. All devices must have the same device 
type, device subtype, density, and record size. You can only use STORESET if 
you purchase TurboSTORE. 
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tapelistspec 
(G. 03. 00 and 
later releases) 



Describes output devices for the STORESET parameter. It has the following 
syntax: 

{tapelist) [, {tapelist)] [.. . ] [ ^tapelist)] 

where parentheses indicate devices grouped for parallel output. 



tapelist Designates a sequential group of output devices. It has the 

following syntax: 

tapedeoice[ ,tapedeuice. . ] [ y tapedeoice] 

tapedeoice Specifies an output device. Must backreference a :FILE 

command. 



NOTE 



When you specify only one tapelist, : STORE numbers the reels you use 
beginning with 1. The first reel is numbered 1, the second is numbered 2, 
and so on. When you specify multiple tapelists (parallel backup devices), 
: STORE numbers the reels from the first tapelist Al, A2, A3, and so on. 
It numbers the reels from the second tapelist Bl, B2, B3, and so on. 



INTER [leave] 



COPYACD 



Instructs : STORE to store files in interleave format. File interleaving 
provides a higher sustained data rate from the disc. Use it to efficiently store 
files to multiple high-speed output devices. You can only use file interleave 
if you purchase TurboSTORE. 

Specifies that Access Control Definitions (ACD) are to be copied. When 
specifying the COPYACD option to store a file, if the file has an ACD 
associated with it, the ACD is evaluated to determine if the user is granted 
access to store the file and the ACD. (RACD permission is required to do 
this. ) If the user is not granted access to the ACD, the file will fail to store. 
If the user is granted access, the ACD will be copied from disc to tape. If no 
ACD is associated with the file, the file will store and an asterisk will be 
printed after the filename. 



USE 

You can issue a : STORE command from a Session, Job, or a Program, but not in BREAK. It is Breakable. 
You must have System Manager (SM), System Supervisor (OP), or Privileged Mode (PM) capability to store 
privileged files. 

OPERATION 

STORE and its many parameters let you perform system backups (if you have System Supervisor (OP) 
capability), backup individual files for your own records, and permanently store unused files to tape. 
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Users with System Manager (SM) or System Supervisor (OP) capability can store any file in the system. 
Users with Account Manager (AM) capability can store any file in their account (except files with 
negative file codes, which they can store only if they also have Privilege Mode (PM) capability). 

Release G. 03. 00 and subsequent releases of MPE support an enhanced version of STORE that speeds 
system backups by copying files sequentially or simultaneously to a group of similar devices. Storing files 
to multiple devices significantly decreases the amount of time necessary to store a large set of files. The 
enhanced : STORE also provides a special format (called interleave format) for quickly storing files to fast 
backup devices. If you use either parallel devices or the interleave format, you must use version G. 03. 00 
or a subsequent version of MPE to restore the files you copy. For information on these : STORE options 
refer to Storing and Restoring Files (32033-901 33). 

Before entering a : STORE command, identify the devices to which you intend to copy files with a : FILE 
command. Backreference the devices in the : STORE command. 

You can issue the : STORE command with the :RUN command. Specify options, file sets, and keywords 
with the INFO= parameter. If you do not specify any INF0= parameters, MPE displays an arrow (< — ) 
prompt. In response, you can enter a complete : STORE command, a complete : RESTORE command, an 
MPE command (preceded by a colon), or :EXIT. 



If you press (BREAK] while storing files, the operation continues while you issue other MPE commands. 
You can use the : ABORT command to cancel the store operation, or the : RESUME command to resume 
receiving : STORE messages. 



EXAMPLES 

To copy all files from the group GP4X in your logon account to tape, first assign the tape device a file 
name then issue a : STORE command. For example: 

: FILE T;DEV=TAPE 
■ STORE @.GP4X;»T;SHOW 

STORE sends a message to the System Console requesting that the Operator mount the tape identified as 
"T". As it stores each file, it lists the file at your terminal. If a file is in use, STORE displays the name 
and the message BUSY. Since you haven't specified a error recovery method, STORE uses the default. 
Below is a sample listing of the files stored: 



FILENAME. GROUP 


•ACCOUNT 


LDN ADDRESS 


REEL 


SECTORS 


CODE 


LABEL. MAC 


.TECHPUBS 


3*1146363 


1 


257 


FIG 


MAI L.MAC 


.TECH PUBS 


1*001 20467 


1 


40 




MAN PLAN 4. MAC 


.TECHPUBS 


2%0 1546471 


1 


844 


RASTR 


MANPLAN5.MAC 


.TECHPUBS 


3*01102561 


1 


544 


RASTR 


FILES STORED: 


4 











To store all files that were modified on or after January 30th, 1984, and to instruct STORE to terminate 
if it encounters tape errors enter: 

: STORE g.e.e;»T;DATE>=1/30/84;ONERROR=QUIT 

To store all files that are not in any PUB group and show the information on your terminal, enter: 

:STORE e.fi.e -@.PUB.@;»T;SH0W 
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To store file ABC and show all possible information on both the system line printer and your terminal, 
enter: 

: STORE ABC; «T; SHOW=LONO, DATES, SECURITY, OFFLINE 
To store files using the specifications in the indirect file INDSTORE, use the following command: 

: STORE ?INDSTORE;«T 

In this example, the indirect file, INDSTORE, contains the following: 

6. PUB. SYS, §.@. TECH PUBS;FILES=32767 
@.@. SUPPORT ;SHOW=LONG, DATES 

To store files using the : RUN command, enter: 

: RUN STORE. PUB. SYS 

<— STORE ABC 

STORE/RESTORE, VERSION 3 (C) 1986 HEWLETT-PACKARD CO. 
MON, APR 16, 1986, 6:27 AM 

FILES STORED: 1 

FILES NOT STORED: 

<-- 

To store files to two sequential tape drives, first describe the tape drives in :FILE commands. 
Backreference the : FILE commands twice in your : STORE command. For example: 

FILE TAPEA;DEV=TAPE;DEN=6250 



FILE TAPEB;DEV=TAPE;DEN=6250 



STORE g.PUB.TECHPUBS;SHOW;STORESET=(«TAPEA,«TAPEB) 



To store files to three similar devices in parallel, use the following form of the STORESET parameter: 
:FILE TAPEA;DEV=TAPE 



FILE TAPEB;DEV=TAPE 



FILE TAPEC;DEV=TAPE 



STORE 6. PUB.TECHPUBS;STORESET=(»TAPEA) , (»TAPEB) , («TAPEC) 



To store files to two parallel groups of two sequential devices, use the following form of STORESET: 
:FILE TAPEA1 ;DEV=TAPE 



FILE TAPEA2;DEV=TAPE 



FILE TAPEB1;DEV=TAPE 



FILE TAPEB2;DEV=TAPE 



STORE 6- PUB. TECH PUBS ;STORESET=(»TA1 ,«TA2) , (»TB1 , »TB2) 



Add the INTER parameter to your : STORE command to copy files in interleave format. For example: 
:FILE TAPEA;DEV=TAPE 



FILE TAPEB;DEV=TAPE 



STORE @.PUB.TECHPUBS;SHOW;STORESET=(«TAPEA,»TAPEB);INTER 
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ADDITIONAL DISCUSSION 

MPE V Storing and Restoring Files (32033-90133). 
MPE V System Backup and Recovery (32033-901 34). 
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:STREAM 

Spools batch jobs or data from a session or job. The optional time-related parameters of the : STREAM 
command may be used to schedule jobs. 

SYNTAX 



: STREAM filename [%char] 

[iKT=timespec] 

{day-of-week} 
[ ; DAY= {day- of -month) [| M=timespec] ] 
{days-until-monih} 

[iDATE= mm/dd/yy[§fitf=timespec]] 

[§jTN= [days] [§hours[§minutes] ] ] 



PARAMETERS 

filename 



char 



AT 
timespec 



DAY 
day-of-week 



The EDITOR file containing the commands of the job. 

The first character of the first record is assumed to be the replacement 
character for the expected colon (:) that identifies MPE commands. The 
user must have READ or EXECUTE access. 

Character used in place of colon ( : ) to identify MPE commands within the 
input file. When the input file is entered on a device configured to accept 
jobs, sessions, or data input via the : DATA command, this character can be 
any ASCII special (non alphanumeric) character except a colon. Default is 
an exclamation point (!). 

Absolute time specification. 

Time specification. This is the absolute time of day in the format HH:MM 
where HH is the hour of the day (0<=HH<=23) and MM is the minute of the 
hour (0<=MM<=59). If DAY or DATE are not specified, timespec is the time 
of the current day. If timespec is earlier than the current time, the next 
day is implied (unless DAY or DATE is specified). 

Absolute day specification. 

Day-of-Week. Allowable values are: 

SUN [DAY] 

MON[DAY] 

TUE[SDAY] 

WED[NESDAY] 

THURSDAY] 

FRIfDAY] 

SATURDAY] 
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day-of-month Day-of-Month. The integers 1 through 31. It indicates the calendar day 

of the month. If dom is greater than or equal to the current 
day-of-month, the current month is indicated. If dom is less than the 
current day-of-month, the next month is indicated. An error message is 
generated if the day-of-month does not correspond to the month (e.g. 31 is 
entered for February). If dom is omitted, the current date is used. 

days-until-monthend Day-from-End-of-Month. The negative integers -31 through -1. It 

indicates the calendar day from the end of the specified month on which 
the job will run. For example, a -1 value represents the last day of the 
month. If the specified day from the end of the month indicates a day 
earlier than the current day, the next month is assumed. For example, if 
today is the seventh day from the end of the month and a -8 value is 
entered, the job will be scheduled for the eighth day from the end of the 
next month. 



DATE 
cusdate 



Absolute date specification. 

Date, specified in the format MM/DD/YY, where MM is the month 
(1<=MM<=12), DD is the day (1<=DD<=31), and YY is the year. If omitted, 
the current date is used. 



IN 
days 



Relative date or time specification. 

Days. A positive integer indicating the offset in days from the current 
date. 



hours 
minutes 



Hours. A positive integer (0</?owrs<=23) indicating the offset in hours 
from the current time. If omitted, zero is used. 

Minutes. A positive integer (0<=minutes<=59) indicating the offset in 
minutes from the current time. If omitted, zero is used. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is Breakable (aborts 
execution and any partially streamed job). 

OPERATION 

With this command you can initiate jobs while in an interactive session by constructing your job from 
your terminal, or by reading records from a card, disc, or tape file. When the job is read, MPE spools it 
onto a disc file, assigns it a job number, and processes it independently as an entity completely separate 
from your session. In the meantime, MPE allows you to continue with your session. 

You can initiate jobs in this way only if the System Operator, or a user who has been given operator 
capabilities, has enabled the MPE Stream Facility by entering the console command : STREAMS. The 
console command : STREAMS also specifies a streaming device, which to MPE appears to be the source of 
your job input regardless of the device you actually use for this input. As a result, the listing device that 
corresponds to the streaming device (and not your terminal) will display the job number assigned by MPE 
and the listing generated by the job. To stream data to disc the input device used must be configured to 
accept the : DATA command. 
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When you enter : STREAM without an input file (that is, with the terminal as the default input device), 
during a session or a job, MPE prompts you for input by displaying a greater than (>) character. When 
you enter : STREAM for a device other than your terminal, MPE does not print the prompt character. 

How to Stream Jobs 

Begin each job in the input file with the ! JOB command and terminate it with the ! EOJ command. Begin 
each data file with the !DATA command and terminate this file with the !EOD command. Begin all 
commands with an appropriate substitute (other than colon) character, as in ! JOB or #DATA. When the 
input file is spooled to disc, MPE replaces the substitute command identifier with a colon, so that the data 
files are properly interpreted when executed. 

After reading the !EOJ command that terminates the job, MPE assigns each job a unique job number 
(JobID). MPE also assigns each job a preset priority, unless you specify otherwise in the : JOB command, 
and processes the job independently of the initiating job. Regardless of which device you use to submit 
the input file, all jobs in that file are treated as though they originated on the unique streaming device 
designated by the System Operator (with the : STREAMS command). The listing for each spooled job and 
the job number are written to the standard list device that corresponds to the streaming device. You may, 
however, use the "OUTCLASS- 1 parameter of the : JOB command to direct the listing to another device. 

How To Time Schedule Jobs 

You may specify the time a job is to enter the WAIT state in absolute or relative time. 

Absolute The user supplies an exact time for the job using the AT parameter with or 

without the DAY or DATE parameter. 

Relative The user specifies a time offset from the current time using the IN 

parameter. 

If the time specified is the same as the current time, the specified job will logon immediately. If the time 
specified is earlier than the current time, a warning message is generated. Otherwise, any time in the 
current century can be specified. 

If no errors are detected, a JobID is displayed on the user's screen. If more than one job is included in the 
inputfile, each job is assigned a unique JobID and all of the jobs will be scheduled at the same time. If the 
inputfile also contains :DATA files, the files will be immediately added to the Input Device Directory 
(IDD). There is a limit of 64 jobs and : DATA files in any one inputfile. 

When a job is scheduled for a future time, it enters the SCHED state. When the specified time is reached, 
the job enters the WAIT state and will be executed when system variables allow. 

Terminating Streamed Jobs 

To terminate interactive job input, enter a colon (:). In response, MPE ceases prompting for batch job 
input and instead prompts you for another MPE command: 



** Denotes end of batch job input. ** 

** MPE prompts for next command. ** 
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Pressing (BREAK! aborts the : STREAM command and any job currently being entered through the 
command. Incompletely spooled disc space is returned to the system. 

If you make an error while entering the MPE : JOB command, you will receive an error message on your 
job listing device. The System Operator, however, receives no indication of the job or the error. 



Terminating Time Scheduled Job 

Jobs that have been scheduled for : STREAM execution can be terminated with the : ABORT JOB command. 
Refer to the MPE System Operation and Resource Management Reference Manual (32033-90005), for 
information on using the :ABORTJOB command to terminate time scheduled jobs. 

Special Considerations 

In order to : STREAM a file, you must have READ and LOCK access or EXECUTE access to that file. 
However, READ and LOCK access would allow general users to obtain security information within the 
file, such as passwords and lockwords. To allow general users to : STREAM the file without giving them 
access to secure information, you may allow EXECUTE access only. For more information on file 
security, refer the MPE V System Operation and Resource Management Reference Manual 
(32033-90005). 



NOTE 



Scheduled jobs will survive a WARMSTART. Any other 
system starts will cause scheduled jobs to be deleted. If the 
system is brought down for any reason, execute a : SHOWJOB 
command to show the scheduled jobs. Then reschedule the 
jobs when the system is brought back up. 

A scheduled job uses an entry in the JMAT table. Because 
of the limited recoverability of scheduled jobs, it is 
recommended that jobs be scheduled no more than a few 
days in advance. 

If a user specifies a day or date for a job, but does not 
specify a time, the job will not enter the WAIT state at 
midnight on the specified day. Instead, it will use the time 
that the : STREAM is executed, and will enter the WAIT state 
at that time on the specified day. 



EXAMPLES 

To stream a job from a disc file, you must name the input file in the : STREAM command: 
: STREAM ABC 
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If you use a character other than an exclamation point (!) as the substitute command identifier in your 
job input, you must identify that character in the : STREAM command. Because you enter this character 
as the second positional parameter in this command, you must always precede it with a delimiting comma, 
even when you omit the input filename (the first parameter): 

: STREAM ,» ** Asterisk used as substitute command identifier. ** 

> «JOB MAC .TECH PUBS 

> »FORTGO MY PROG 

>*EOJ 

#J74 

>: 



If your job input file contains subsystem commands, such as commands directed to the editor, do not enter 
any command identifier character at the beginning of these commands. For instance, when using the 
Editor, enter the subsystem commands as follows: 

: STREAM EXAMPLE ** The job input file is EXAMPLE. ** 

! JOB WXYZ, WRITER. TECH PUBS , MAC ** Initiates the job WXYZ. ** 

! EDITOR ** Invokes the Editor. ** 

TEXT ABC ** Subsystem commands without (!) as an identifier. ** 
LIST ALL, OFFLINE 
EXIT 

! EOJ ** Terminates job. ** 

#J87 ** Job number supplied by MPE. ** 



If you want the job listing to appear on a device other than the standard listing device associated with the 
streaming device, you can specify this other device in the MPE : JOB command. Enter: 

: STREAM 

>!JOB MAC.TECHPUBS;OUTCLASS=12 

If you stream a job from an interactive device, the system may prompt you for omitted passwords 
depending on how your System Manager has configured security features. 

The following section contains additional examples of : STREAM command usage. For these examples, 
assume that the current date and time are Monday, April 16, 1984, 12:00 p.m. Also assume jobfile 
contains a valid : STREAM job. 

: STREAM JOBFILE JOBFILE will be introduced immediately. 

; STREAM JOBFILE;AT=8;00 JOBFILE will be introduced at 8:00 a.m., 

Tuesday, April 1 7. 

: STREAM J0BFILE;AT=20:00 JOBFILE will be introduced at 8:00 p.m., 

Monday, April 1 6. 

: STREAM J0BFILE;IN=,8 JOBFILE will be introduced in eight hours, at 

8:00 p.m., Monday, April 16. 

: STREAM JOBFILE;IN=1 ,8 JOBFILE will be introduced in one day plus eight 

hours, at 8:00 p. m. , Tuesday, April 1 7. 
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: STREAM JOBFI LE;DAY=M0N;AT=8: 00 



: STREAM JOBFI LE ; DAY=MONDAY ; AT=20 : 00 



: STREAM JOBFILE;DAY=17;AT=20:00 



: STREAM JOBFI LE;DAY=5 



: STREAM JOBFI LE; DAY =31 



: STREAM JOBFI LE;DAY-2 



; STREAM JOBFI LE;DAY-20 



: STREAM JOBFI LE;DATE=4/1 6/84; AT=8; 00 



; STREAM JOBFI LE ; DATE=4/ 16/84; AT=20 : 00 



Since the time specified (8:00 a.m.) is earlier 
than the current time, JOBFI LE will be 
introduced at 8:00 a.m., Monday, April 23. 

Since the time specified (8:00 p.m.) is later than 
the current time, JOBFI LE will be introduced at 
8:00 p. m. , Monday, April 1 6. 

Since the day of the month (17) is later than the 
current day of the month (16), the current 
month is assumed. JOBFI LE will be introduced 
on Tuesday, April 1 7, at 8:00 p.m. 

Since the day of the month (5) is earlier than the 
current day (16), the next month is assumed. 
Since no time was specified, JOBFI LE will be 
introduced on Saturday, May 5, at 12:00 p.m. 

Since there is no April 31, the next month is 
assumed. Since there is a May 31, this is a legal 
command. JOBFI LE will be introduced on 
Thursday, May 3 1, at 1 2:00 p. m. If there was no 
May 31, this would result in an error. 

The "-2" means the second to last day of the 
month, and since no time was specified, the 
current time is used. JOBFI LE will be 
introduced on Sunday, April 29, at 1 2:00 p.m. 

The "-20" means the twentieth day from the 
end of the month. If one assumes the current 
month, that implies April 11, but April 11 is 
earlier than the current day; therefore, the next 
month is assumed. JOBFI LE will be introduced 
on Saturday, May 12, at 12:00 p.m. 

Since the specified time is earlier than the 
current time, this command is not legal and will 
result in an error. 

The specified time is later than the current time, 
so this command is legal. JOBFILE will be 
introduced on Monday, April 16, at 8:00 p.m. 



ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
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STREAMS 



Enables or disables the streams device: it permits users to submit job/data streams, or prevents them from 
doing so. 

SYNTAX 



STREAMS <#» 



PARAMETERS 

IdeO The logical device number of the STREAMS device. This device must also 

have an output device number or class that references logical devices of 
type 32. Any input device, except the system console or terminals, may be 
used, providing that it was configured as job -accepting in the SYSDUMP 
dialogue. 

OFF Disables the STREAMS facility. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console. * 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

The Operator executes this command after a startup to enable the STREAMS facility. The : STREAMS 
device must be enabled each time the system is brought back online in order to to allow users to stream 
jobs. (Streamed jobs are processed separately by MPE, allowing users to continue with other work at their 
terminal. If the streamed job is submitted on a tape drive rather than from a terminal, MPE will process 
it without requiring the user's attention.) Any attempt to stream a job when the : STREAMS facility is 
disabled generates the following message: 

STREAM FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 

The device normally configured as the streams device is Idev 1 0. However, Idev 1 may not correspond to 
an actual device, such as a tape drive or card reader, physically connected to the computer. If this is the 
case, then the STREAMS device is considered a "psuedo-device". Regardless of whether the device 
physically exists or not, it must be entered into the I/O Configuration table as a legitimate logical device. 
It must be assigned the device class JOBTAPE. 
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EXAMPLES 

To enable jobs and data streams on logical device number 1 0, enter: 

: STREAMS 10 
To disable data streams, enter: 

: STREAMS OFF 

ADDITIONAL DISCUSSION 

Refer to the discussion of "JOB" and to the : STREAM command in this manual. 
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:SUSPENDSPOOL 



Suspends output to a spooled device. 

SYNTAX 



PARAMETERS 

IdeO The logical device number of a spooled device. 

FINISH Directs the device to complete the currently active spoolfile and then stop. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console. * 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

When the spooler process is suspended, the message "SP# Idev SPOOLER SUSPENDED " is displayed on the 
Console. You may also determine the spooler's status by entering "rSHOWOUT SP;JOB=g". If suspended, 
any spoolfiles listed will be READY for printing; none will be ACTIVE, and a :SHOWDEV of the spooled 
device will indicate that the device is still spooled. Refer to the rSHOWOUT command in this manual. 

When suspending an ACTIVE spoolfile, you should first take the output device offline. This gives you time 
to enter the command and determine that the ACTIVE file is the one being printed. If you issue 
rSUSPENDSPOOL without taking the device offline, that file might finish printing while you enter the 
command and another file might start. 

When your instruction has been sent to the spooler process, MPE will return a colon prompt ( : ). The 
command will not be executed, however, until the output device is returned online. Only then will you 
receive the "SPOOLER SUSPENDED" message. 

EXAMPLES 

To suspend printing on logical device 6 (the line printer), enter: 

: SUSPENDS POOL 6 
To suspend printing on logical device 6 once the currently active spoolfile is completely printed, enter: 

rSUSPENDSPOOL 6;FINISH 
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:SWITCHLOG 



Closes the current system log file, then creates and opens a new one. 

SYNTAX 




PARAMETERS 

None. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
requires System Supervisor (OP) capability or must be issued from the Console.* 

* Unless may be distributed to users with the : ALLOW command. 

OPERATION 

When the :SWITCHLOG command is executed, MPE displays the previous system log file number ( xxxx ), 
the percentage of file space used {yy) y and the current open log file (zzzz), as shown in the following 
example: 

LOGFILE LOG xxxx IS yy% FULL 
LOG FILE NUMBER zzzz ON 

If logging is enabled but currently suspended, MPE displays the following message: 

NO LOGGING 

LOG FILE xxxx IS yy% FULL 



NOTE 



You should not : BUILD new log files, since MPE creates 
them automatically. If you do use : BUILD to create a new 
log file, and then attempt to switch the current log file to 
the file you created, user logging will suspend in an error 
state. The following message will be displayed: 

LOG FILE NUMBER xxxx ERROR #100. 
LOGGING SUSPENDED. 
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EXAMPLE 

To switch logging to a new Log File, enter: 
: SWITCH LOG 

ADDITIONAL DISCUSSION 

Refer to :RESUMELOG in this section, and to the discussion of "MPE LOGGING FACILITIES" in the MPE 
System Operation and Resource Management Reference Manual (32033-90005). 
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:SYSDUMP 



Starts the Configurator dialogue, and copies all system and user files to magnetic tape or serial disc and 
creates a backup of your system, user files, and configuration data. 

SYNTAX 



rSYSDUMP <* NULL > 



{dumpfile} [§otuxlistfile] 



PARAMETERS 

dumpfile The destination file of the modified or duplicate system, previously defined 

with the : FI LE command. The dumpfile must backreference a magnetic 
tape or serial disc file. 

$NULL Allows the operator to step through the configuration dialogue and alter 

system parameters without actually changing the system. 

auxlistfile Actual file designator of the output devicefile to which all listings 

requested during the Configurator/User dialogue are written. The formal 
file designator used by the MPE SEGMENTER for this file (when it is 
invoked to add or replace SL segments) is SEGLIST. Default is $STDLIST. 
It may backreference a magnetic tape or serial disc file. 

USE 

This command may be issued from a Session or a Job, but not in BREAK or from a Program. It is 
Breakable (suspends execution). It requires System Supervisor (OP) capability. 

OPERATION 

When the :SYSDUMP command is executed, you must direct MPE to write the output to a specific device. 
To do so, precede the :SYSDUMP command line with two file equations. Then back- reference these files 
by preceding the dumpfile parameter and the auxlistfile parameter with an asterisk («) on the :SYSDUMP 
command line. To associate dumpfile with a tape drive, for example, enter: 

:FILE DUMP;DEV=TAPE 

Similarly, to produce the output listing from the SYSDUMP command on a line printer, enter: 

;FILE LIST;DEV=LP 
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In general, use the following format for the : FILE command: 

: F I LE formaldesignator [ =filereference ] ; DEV=ctevice [ ; REC=recsize [ DEti=density ] ] 

Where: 

• Device specifies is the device class name or Idev number of a tape drive or serial disc. 

• Recsize determines the size of the blocks on the store tape. The record size may be any multiple of 
256 words, with a maximum record size of 81 92 words for tape or serial discs. 

• Density specifies the tape density in characters-per-inch (CPI). This parameter is only used for 
variable-density tape drives. The values allowed for tape drives are: HP 7976A - 1600, 6250; HP 
7974 - 800, 1600; HP 7978 - 1600, 6250. 

Once you have designated the peripheral devices that dump file and auxlistfite refer to, issue the : SYS DUMP 
command, preceding each filename with an asterisk (*) to indicate a backreference to the definitions in 
the : FILE commands. 

The :SYSDUMP command invokes the : STORE command after writing system information to the 
beginning of the tape. Progress messages will appear once the system begins writing user files to the tape. 

The default interval is one minute, however, during : SYS DUMP dialog, you may specify your own 
preferred interval, in minutes, by using the : PROGRESS keyword in response to the "ENTER DUMP FILE 
SUBSETS" prompt. Refer to the : STORE command in this section. 



NOTE 



To start the Configurator dialog without coping data to 
tape, use the system defined file $NULL as the dumpfile. 
MPE will accept this file specification, and open the file as 
though it were a standard file, but will perform no 
corresponding write operation. :SYSDUMP $NULL allows you 
to examine the current configuration, and even make 
"changes" to it, without affecting the system in any way. It 
will terminate with an error message, which you may 
ignore. 



EXAMPLE 



Enter :SYSDUMP to begin dialog with the MPE Configurator. Once the dialog is complete, configuration 
changes are copied to the "DUMP" file, and any listings requested during the dialog are output to the file 
named LIST. In the example below, the first file equation directs the output of the :SYSDUMP command 
to a tape drive. The second file equation will send any listings generated during the Configuration dialog 
to a line printer. 

FILE DUMP;DEV=TAPE 



FILE LIST;DEV=LP 



SYSDUMP»DUMP,»LIST 
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During : SYS DUMP dialog you must specify an interval, in minutes, for progress messages (the default is one 
minute): 

: SYS DUMP »T 

ANY CHANGES? NO 

ENTER DUMP DATE? 8/15/85 

ENTER DUMP FILE SUBSET(S) @. 6 . 6 ; FI LES=20000 ; PR0GRESS=3 

ADDITIONAL DISCUSSION 

For a full discussion of the :SYSDUMP command, refer to the sections titled "THE SYSTEM SUPERVISOR" 
and "CONFIGURING YOUR SYSTEM" in the MPE V System Operation and Resource Management 
Reference Manual (32033-90005). 
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:TAKE 



Releases a device previously assigned to diagnostics so that it may be brought online. 

SYNTAX 



:TAKE IdeO 



PARAMETERS 

Ideo The logical device number of the device taken from diagnostics. 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

After diagnostic testing, the :TAKE command must be issued to release the device from diagnostic control. 
Only then can it be brought online with the : UP command. 

EXAMPLE 

To take logical device number 35 from diagnostics and bring it back online enter: 
:TAKE 35 



UP 35 



SHOWDEV 35 



LDEV AVAIL OWNERSHIP VOLID ASSOCIATION 
35 A AVAIL UP 
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TELL 



Sends a message to another session. 



SYNTAX 





<[#]Smw 


} 






(username 


.acctname} 




:TELL 


<e 


Mil 


, ] text } 




{Q.acctname } 






m 


) 





PARAMETERS 



[t]Snnn 



username . accountname 



The session number as assigned by MPE. This session number will 
receive the TELL message. 

The name of the session or user to receive the message, and the 
account name to which the message is directed. This parameter is 
the same as the session identity entered with the : HELLO command. 
Issuing a SHOWJOB commands lists all the user, account names to 
which you may direct a TELL message. Users who have issued a 
:SETMSG OFF command will be listed as being in QUIET mode and 
will not receive your TELL message. If several users are running 
under the same session identity, MPE will send the message to all of 
them. 



6 

6. acctname 

is 

text 



If a TELL message is sent to the System Console while it is running 
in QUIET mode it will not be received. To override QUIET mode, 
use the : TEL LOP command which will deliver any message sent to 
the device designated as the System Console. 

All sessions. 

All sessions under the account name established by the System 
Manager. 

All sessions. This is the same as the § parameter. 

Message text, preceded by a space or a semi -colon (:) and consisting 
of any string of ASCII characters. The default is that no text is 
printed; however, MPE still prints the "FROM" message as follows: 

FROM/ sessionid 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 
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OPERATION 

This command transmits a message from the sender's job or session to one or more sessions currently 
running. The message appears on the receiving session list device. Messages sent with this command may 
include escape and control characters that invoke bells or inverse video. If a message is sent to a terminal 
that is currently interacting with a program, MPE queues the message as high as possible among the 
current input/output requests but does not interrupt reading or writing in progress. If the session or user 
designated to receive the message is not running, or if the job is spooled, the transmitting job/session 
receives a system message indicating this. MPE blocks the :TELL command if the receiving session 
(including the System Console) is operating in the quiet mode (refer to : SETMSG command) and informs 
the sender with: 

Snnn usernarne .acctname NOT ACCEPTING MESSAGES 

You cannot send TELL messages to a job or to yourself. If you try to send a message to a job the following 
warning is issued: 

#Jnn NOT INTERACTIVE; MESSAGE NOT SENT TO JOB (CIWARN 1627) 

EXAMPLES 

To send a message to a user identified as BROWN logged on under account A running a session named 
BROWNSES telling him to use a particular file, enter: 

: TELL BROWNSES,BROWN.A USE FILEX 

To send a message asking all users logged on in account A to log off, enter: 

:TELL g.A PLEASE LOG OFF 
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:TELLOP 

Sends a message to System Console. 
SYNTAX 




PARAMETER 

text Message text, preceded by a space or a semi -colon (:) and consisting of any 

string of ASCII characters. Default is that no text is printed; however, 
MPE still prints the "FROM" as follows: 

FROM/ session id 

USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. 

OPERATION 

This command sends a message to the System Console. The message text appears on the System Console, 
preceded by the time it was transmitted and your job/session number. Like messages transmitted between 
users (:TELL command), this message is printed as soon as possible without interrupting any console 
input/Output Currently in progress. The message is sent to the device designated as the System Console, 
even if no session is logged on. 

EXAMPLE 

To send a message to the System Operator instructing him to mount a tape, enter: 
t TELLOP PLS MOUNT MVTAPE,VERSION 1 
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:TUNE 



Changes the filter and/or priority limits of circular subqueues; it also changes the value of the memory 
manager algorithm threshold. 

SYNTAX 




CAUTION 



Misuse of this command can significantly degrade system 
operating efficiency. 



PARAMETERS 

minclockcycle 
base 



limit 



nnn 



max 



Minimum number of milliseconds allotted for the replacement algorithm to 
cycle through memory. If it cycles through memory in less time, memory 
allocation is delayed and prevents disc thrashing. 

Priority at which processes that execute in the CS, DS, or ES subqueue begin 
in their respective queues. These processing queues, also referred to as 
"circular subqueues", are used by MPE to differentiate processes according 
to the amount of CPU processing time allotted to each, among other things. 
A process executing in the ES subqueue, for example, will be initiated only 
if all higher-priority processes are not ready to run. As a result that a 
process in the ES subqueue it may execute more slowly. In general, the more 
critical the process, the higher the subqueue it should be assigned. 

Highest priority which processes executing in the CS, DS, or ES subqueues 
can attain. 

The minimum number of milliseconds (filter value) that a process may use 
the CPU before its priority is reduced. 

The maximum number of milliseconds (filter value) that a process may use 
the CPU before its priority is reduced. The value of max must be greater 
than or equal to the value of nun. 



USE 

This command may be issued from a Session, Job, or in BREAK, but not from a Program, 
(aborts execution). It requires System Supervisor (OP) or System Manager (SM) capability. 



It is Breakable 
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OPERATION 

The System Supervisor uses the :TUNE command to change the filter or priority limits of a circular 
subqueue and/or the value of the manager algorithm threshold. The command is used primarily in online 
tuning, so that the system can manage the current processing load efficiently. 

For processes executing in the CS subqueue, the parameters min and max refer to the absolute limits of the 
"average short transaction time", or filter. This filter is recomputed after every transaction is complete, 
and then compared against the CPU time of each process to determine whether the priority of the process 
should be decreased. By contrast, processes executing in the DS or ES subqueues use a fixed value rather 
than an average. The same value is used for both queues and is specified by setting min and max equal to 
the desired value. Both min and max must be specified, but if they are not given the same value, the 
value of max is used. 

At least one of the parameters (minclockcycle, base, limit, min, or max) must be specified. The values for 
base and limit may range from 150 to 255 . Parameters are positional: min is changed without specifying 
base and limit, it must be preceded by two commas. If minclockcycle is omitted, the queue specification 
( CQ , DQ , or EQ ) must be preceded by a semicolon ( ; ). 

When a process begins executing in the CS subqueue, it is given a priority of CBASE. When a process stops 
(for disc I/O, terminal I/O, preemption, etc), its new priority is determined so that it may be requeued for 
the CPU. If the process has completed a transaction, defined as the time between terminal reads, its 
priority becomes CBASE , and the value of an "average short transaction" is recalculated. If the CS process 
has not completed a transaction, and if the process has exceeded the filter value since its priority was last 
reduced, the priority is decreased (but will not exceed the CUM IT ). 

DS and ES processes begin at DBASE and EBASE respectively, and are rescheduled according to the same 
criteria used for CS process. However, a fixed value (the value of max, specified for the subqueue) is used 
in place of the "average short transaction time", which is used for CS processes only. If the values 
specified for max in the CS , DS , and ES queues are too large, system response may become erratic. If 
they are too small, excessive memory management may occur, because process -swapping occurs too 
frequently. In either case, system performance is degraded. The recommended settings for min and max 
for the CS subqueue are and 300 respectively, since short transactions are favored in most cases. A 
value for min and max of 1 000 usually produces efficient system operation for the DS and ES subqueues. 

The values assigned for limit specify the lowest priority (largest number) that the system can assign to a 
process in a particular queue. 

The minclockcycle parameter is used by the memory manager to determine when thrashing (excessive 
memory management activity) is occurring. Making this value smaller increases the probability of 
thrashing. The recommended value for this parameter is 1 000 . 
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The following default settings are in when the system is cold loaded from the system disc (a 
WARMSTART or COOLSTART). 



minclockcycle. 1 000 



CQ base: 

limit: 

mtn: 

max 



152 

200 



300 



DQ base: 


202 


limit: 


238 


mtn: 


1000 


max: 


1000 



base: 


240 


limit: 


253 


mtn: 


1000 


max: 


1000 



EXAMPLE 

To set the minimum clock cycle to 1 000 , CQ base to 1 52 , limit to 200 , and CQ maximum filter to 300 ; 
and DQ base to 202 , DQ limit to 238 , DQ (and EQ ) minimum and maximum filter to 1 000 , enter: 

; TUNE 1000;CQ=1 52, 200, 0,300;DQ=202, 238, 1000, 1000 

ADDITIONAL DISCUSSION 

For additional information about process scheduling, refer to the discussion of "PROCESS SCHEDULING" 
in Section III of the MPE V Intrinsics Reference Manual (32033-90007). 
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UP 



Returns a particular device to its normal function on the system; cancels a : DOWN command that had been 
issued for the device. 

SYNTAX 



:UP Idev 



PARAMETERS 

Ideo The logical device number of the device being returned to service online. 

USE 

This command may be issued from a Session, Job, in a BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console.* 

* Unless distributed to users with the : ALLOW or : ASSOCIATE commands. 

OPERATION 

This command makes available to users a device previously taken offline with the :DOWN command. 
Ownership of the device is not affected by the : UP command: If a device is owned by the system at the 
time it is downed, the system will retain ownership even after the : UP command is executed. 

EXAMPLE 

To allow logical device number 1 to function again, enter: 

; UP 10 

: SH0WDEV 10 

LDEV AVAIL OWNERSHIP VOLID ASSOCIATION 

10 A AVAIL 

ADDITIONAL DISCUSSION 

Refer to the : DOWN command in this manual. 
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:VINIT 



Runs the VINIT subsystem to format, initialize, and label private volumes, serial discs, and foreign discs. 

SYNTAX 



; VINIT [listdeoice] 



PARAMETERS 

listdevioe 



Name of the device to receive output generated by the VINIT subsystem. 
This parameter must backreference a :FILE command that names the 
device. Default is $STDLIST . 



FUNCTIONS 

>COND Ideo 
[pECOVER] 

>COPY fromLdn%toldn 
[ i;GEN= [genindex] ] 
[;VER[IFY]] 
[|BUF=s£zej 

[Idea] 
>DSTAT [ALL] 
[ § ] 

>DTRACK Ideo 



>EXIT 
>FOREIGN IdeO 



> FORMAT Ideo 

E||IBM[ : Ootid]] 

>HELP 



>INIT oname%ldeo 

[ < Osname%groupQacct ] 
[%GZU=genindex] 

>PDEFN [ * .group. account] 
[osname . group .account] 



Condenses free disc space and recovers lost disc space for 
private volumes. 

Copies the contents of one volume to another. 



Displays status of disc drives. 



Processes suspect tracks in the Defective Track Table and 
defective sectors in the Defective Sectors Table. In doing so, 
you can either recover (i.e. ignore), delete, or reassign the 
defective tracks. 

Exits the VINIT subsystem. 

Makes a disc volume foreign by filling the label area of a 
volume with zeros. 

Allows online formatting of disc packs. 



Prints a listing of the VINIT commands, including syntax 
and descriptions, at $STDLIST. 

Completes the conditioning of a private volume previously 
formatted by the SLEUTHSM program or the >FORMAT 
command. 

Lists the specified volume set. The asterisk (*) specifies the 
home volume set. Default is the home volume set. 
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>PDTRACK IdeO 



>PFSPACE 



{ldei)[gABDR]) 



{ALL 



} 



Prints the contents from the Defective Tracks Table or the 
Defective Sectors Table at $STDLIST. 

Prints the Disc Free Space Map at $STDLIST. 



>PLABEL IdeO 

>SCRATCH IdeO llRESET] 

>SERIAL IdeO 

> VERIFY IdeV [1|DTT] 



Prints the disc label at $STDLIST. 
Writes (resets) a scratch-type label. 
Writes a serial disc -type label. 
Verifies (reads) data. 



Each of the parameters referenced in the above : VI NIT functions is defined below and discussed in detail 
under the heading "PRIVATE VOLUMES" in the MPE V System Operation and Resource Management 
Reference Manual (32033-90005). 



IdeO 



fromldn 



toldn 



genindex 



VER[IFY] 



size 
lW[:i)olid] 

vname 

vsname. group, 
acot 

ADDR 



The logical device number of the disc drive on which the volume is 
mounted. 

The logical device number of the disc from which data will be copied 
Unless the device is a system domain disc, you must first remove it from 
normal system use by issuing a : DOWN command for the device. 

The logical device number of the disc volume to which data will be copied. 
The device must be in the DOWN state. You must first remove the device 
from normal system by issuing a : DOWN command for the device. 

A value from to 32767, inclusive, indicating the generation index of the 
disc volume. If not specified, the genindex of toldn will be one greater than 
the genindex of fromldn. This parameter is valid only for private volumes. 

Checks the readability of data on the destination drive. If an error is 
detected, VER [I FY] directs the : VI NIT subsystem to attempt to recover the 
track. If it is unrecoverable, the track is reassigned and : VI NIT will 
attempt to copy data once again. The VERIFY keyword may be abbreviated 
as VER. 

The internal buffer size, which may be a value from 1 to 32, inclusive. 

Indicates that the disc is a single-sided IBM-formatted diskette. If volid is 
specified, it denotes an IBM volume identifier other than the default volid 
of IBMIRD. 

The name of the disc volume which is a member of the volume set. 

The name of the volume set. 



Displays the Disc Free Space entries for the specified logical device. 
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ALL or A Displays the Disc Free Space Map in table format for all systems and 

private volumes which are physically mounted. 

RESET Resets a volume from scratch to non-scratch. 

DTT Directs : VI NIT to verify only suspect sectors/tracks as recorded in the 

Defective Sectors/Tracks Table. This option is not applicable to serial or 
foreign discs or cartridge tapes. 

USE 

This command may be issued from a Session, or a Job, but not in BREAK or from a Program. It is 
Breakable (aborts execution). It requires System Supervisor (OP) or System Manager (SM) capability. 

OPERATION 

The :VINIT command accesses the VINIT subsystem, which includes commands for online initialization, 
labeling, and formatting of Private Volumes. 

EXAMPLE 

; FILE LIST;PEV=LP 
:VINIT "LIST 



NOTE 



In JOB mode, the VINIT subsystem can be invoked only as 
follows: 

•RUN PVINIT.PUB.SYS 

ADDITIONAL DISCUSSION 

Refer to VINIT in "SUBSYSTEMS AND UTILITIES" of the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). 



2-406 



:VMOUNT 



Enables or disables MPE's Private Volumes Facility. 

SYNTAX 



:VMOUNT W1 AUT °J>[1ALL] 



PARAMETERS 

ON or 
ON, AUTO 



OFF 
ALL 

USE 



Enables the Private Volume Facility so that all valid user : MOUNT and 
Operator : LMOUNT requests are allowed. When "ON " is used without "AUTO 
", the Operator must reply to all : MOUNT requests. When ON, AUTO is used, 
MPE attempts to satisfy user : MOUNT and Operator : LMOUNT requests 
without Operator intervention. 

Requests to use the Private Volumes Facility will be rejected. 

Prints all Private Volumes mount-related console messages, including those 
not requiring Operator intervention, on the Console. 



This command may be issued from a Session, Job, in BREAX, or from a Program. It is not Breakable. It 
may be issued only from the Console. * 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

If the Private Volumes Facility is enabled when you issue a : VMOUNT OFF command, users having 
mounted volume sets will be unaffected; the command will be satisfied when the last access is complete. 

Once the Private Volumes facility has been enabled, use the :DSTAT command to determine which 
volumes are actually mounted, and the :VSUSER command to determine which users are using particular 
volume sets. Refer to the : DSTAT and : VUSER commands in this section. 

The Private Volumes Facility is disabled immediately following a system startup (the setting is equivalent 
to :VMOUNT OFF; ALL ). However, you will still receive Console messages concerning private volume 
requests. 

The Operator will have the greatest interactive control over the use of private volumes by using : VMOUNT 
ON; ALL. The command that least interrupts the Operator when users are accessing private volumes is 
: VMOUNT ON, AUTO. 
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EXAMPLES 

To disable the Private Volumes Facility so that no messages are sent to the Console when users attempt to 
mount private volumes (the default condition) enter: 

; VHOUNT OFF 

To disable the Private Volumes Facility and still receive messages on the Console when users attempt to 
mount private volumes, enter: 

: VHOUNT OFF; ALL 

ADDITIONAL DISCUSSION 

Refer to the discussion of "PRIVATE VOLUMES" in the MPE V System Operation and Resource 
Management Reference Manual (32033-90005). 
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:VSUSER 

Lists all users of a currently mounted, nonsystem volume set. 

SYNTAX 



:VSUSER [osname] 



PARAMETER 

ys "<*"« A f«Uy qualified volume set name. Default is that information for all 

currently mounted volume sets are listed. 



USE 

This command may be issued from a Session, Job, or in BREAK, but not from a Program. It is not 
Breakable. 

OPERATION 

The :VUSER command lists all users who have explicitly or implicitly mounted a nonsystem volume set. It 
also displays the volume set name, job number, and the group and account names of all users currently 
performing a mount function. The : MOUNT/ DISMOUNT commands enable users to perform an explicit 
mounting; the FOPEN/CLOSE intrinsics enable them to perform an implicit mounting. You must have UV 
(Use Volumes) or CV (Create Volumes) capability to use this command. Refer to the : MOUNT and 
: DISMOUNT commands in this section. 

EXAMPLE 

To list all of the currently mounted volume sets, enter: 

: VSUSER 

VOLUME SET NAME JOBNUM JOBNAME 

USER. MAN ACER #S260 NORMA. MPEM 

ADDITIONAL DISCUSSION 

MPE V System Operation and Resource Management Reference Manual (32033-90005) 
MPE V Intrinsics Manual (32033-90007) 
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WARN 



Sends an urgent message to jobs/sessions. 

SYNTAX 



> 



:WARN 



<[jsname,luser.acct> 



PARAMETERS 

6 

§Jnn 

tSnn 

jsname , user . acct 



text 



All users receive the message (QUIET and nonquiet). 

A job number (assigned by MPE) for the job that is to receive the message. 

A job number (assigned by MPE) for the job that is to receive the message. 
Only jobs submitted on interactive devices can receive messages. 

The names of the job/session and user to receive the message, and the 
account name under which they are funning. (These names are the same as 
those entered with the : JOB or : HELLO command. ) 

If several users are running under the same job/session identity, MPE will 
send the message to all of them. 

The message text, consisting of any string of AS CII char acters no more than 
67 characters. The message is terminated by a [RETURNI . Default is that no 
message is printed. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

Sends an urgent message, interrupting any current pending read or write in progress. The message will 
appear on the list devices of all sessions (even those that are QUIET ) as: 

OPERATOR WARNING: text 

Messages sent with the :WARN command will be received by jobs only if the job was submitted on an 
interactive device. 

The user has the option of running his session in QUIET mode. In that case, :TELL messages from other 
users will be suppressed. :WARN messages generated at the system console, however, override QUIET mode. 
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NOTE 

Use caution when sending a warning to users. The :WARN 
command overrides a block mode screen. 

EXAMPLE 

To send a WARN message to all sessions, followed by a WARM message to session #S51 , enter: 

■• WARN g; THE SYSTEM WILL SHUTDOWN IN 5 MINUTES. PLS LOG OFF. 
; WARN #S51;LAST CHANCE TO LOG OFF GRACEFULLY. 
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WELCOME 



Defines the welcome message. 

SYNTAX 



:WELCOME [toelcfile] 



PARAMETERS 

Welcfile An ASCII file containing the new welcome message. 



USE 

This command may be issued from a Session, Job, in BREAK, or from a Program. It is not Breakable. It 
may be issued only from the Console.* 

* Unless distributed to users with the : ALLOW command. 

OPERATION 

The Operator uses the : WELCOME command to compose the message that will be transmitted to users when 
they initiate jobs and sessions. The message is retained when you WARMSTART or COOLSTART the 
system, or choose the UPDATE restart option. 

To define the welcome message, enter ": WELCOME" and press " 1RETURN1 ". When the "#" prompt is displayed, 
begin entering the text of the message. Any number of lines may be used, but the leng th of an y line 
cannot exceed 72 characters. To terminate the message and complete the command, enter [RETURN) at the 
"#" prompt. 

To define the welcome message from an editor file merely specify the welcfile parameter. Subsequent 
changes to the editor file will not affect the welcome message until another : WELCOME command is issued 
with the filename specified. 



NOTE 



If no parameter is specified, you are prompted to enter the 
new message interactively. 

To delete the old welcome message, issue the : WELCOME command and enter [RETURN) at the # prompt. 
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EXAMPLE 

To create a multi-line welcome message, enter: 

: WELCOME 

# WELCOME TO THE HP3000 COMPUTER SYSTEM. 

# FILES WILL BE STORED EACH DAY BETWEEN 6AM AND 7AM. 

# [RETURN] ~" " "~ " 
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USER DEFINED COMMANDS 



SECTION 



III 



MPE allows you to define your own commands to fit specific needs. To build a user defined command, or 
UDC, you may use Editor, or another ASCII text editor, to combine several standard MPE commands into 
a single list. Assi gn a na me to that list and save it. To invoke the UDC, enter its name at an MPE 
prompt and press [RETURNI : all of the commands in the UDC list will execute. A user defined command 
may be used in most instances where a standard MPE command may be used, even within another UDC. 
User defined commands cannot, however, be executed through the COMMAND intrinsic, or from within 
subsystems, unless you are in BREAK. 

The UDC definitions are stored in one or more files. These files can exist at one of three different levels: 
user, account, or system. UDCs may be created by any user for personal use, by the Account Manager for 
anyone using the account, or by the System Manager for user on the system. System wide UDCs must be 
defined in a file that is released for all users to use. 

When identically named UDCs occur at different levels, the user level UDC takes precedence over the 
account level UDC, which in turn takes precedence over the system level UDC. For this reason, it is a 
good practice to give your UDCs unique names. Exceptions to this rule, nested and logon UDCs, are 
discussed later in this section. 

You must have special capabilities to establish account or system level UDCs. For information on System 
Manager, Account Manager, and System Supervisor capabilities, refer to the MPE V System Operation and 
Resource Management Reference Manual (32002-90005). 



NOTE 



No UDC name may consist of, or start with, the characters 
RFA, since RFA is reserved for internal use. Names like 
RFAST, as well as the name RFA, are thus illegal. Although 
the HELP subsystem will show such UDCs in their correct 
form, the command interpreter will not recognize them and 
will issue the error message: "UNKNOWN COMMAND NAME 
(CIERR 975)". 



The :SHOWCATALOG command lists the UDCs currently in effect, the level at which they are defined, and 
the file in which they reside: 



:SHOWCATALOG 




UDCU.TOM.MPE 




WELCOME 


USER 


T 


USER 


UDCA.PUB.MPE 




LIST 


ACCOUNT 


FCOPY 


ACCOUNT 


UDCS. PUB. SYS 




R 


SYSTEM 



** Name of file containing UDC definitions ** 

** UDC name and level ** 
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If a UDC name that you do not recognize appears in the catalog, the :HELP command can be used to 
discover the content of that UDC, unless OPTION NOHELP has been specified for that UDC. Refer to 
"EXECUTION OPTIONS", later in this section. Suppose, for example, that :SHOWCATAL0G reveals an 
unfamiliar UDC named SJ. To find out exactly what that UDC contains, enter: 

: HELP SJ **The UDC name used as a parameter of HELP** 

USER DEFINED COMMAND: 

SJ 
SHOWJOB 



SYNTAX OF UDCs 

A user defined command has of two parts: a header section containing control information, and a body 
consisting of MPE commands. 

Header 

The control information in the header section of a UDC consists of: 

• The command name, composed of alphanumeric characters (16 maximum) and beginning with an 
alphabetic character. You cannot use the reserved word RFA as a UDC name or at the beginning of a 
UDC name. 

• Parameters and their optional default values (maximum 1 6). 

• Execution options (LIST/NOLIST, BREAK/NOBREAK, LOGON /NOLOGON, HELP/NOHELP). 

THE COMMAND NAME. The first line (including continuation lines) in the header of a UDC gives the 
Command Interpreter the name of the command, any parameters, and the defaults for those parameters. 
An minimum first line could be: 



In this example, the command is named A It has no parameters. UDC headers may be more complex, if 
you choose to specify options or parameters. A UDC header may extend over more than one physical line 
and may contain as many has 320 characters. Each line to be continued must end with an ampersand 
(&) as the last nonblank character. 

PARAMETERS. UDC parameters are variables that are passed from the calling command (the UDC 
name) to the body of the UDC. This allows a general UDC to serve different specific purposes. 

EXECUTION OPTIONS. There are several options that you may wish to specify in the UDC header. 
The options, or their defaults are invoked when the UDC executes. The options available for use in a 
UDC declaration are explained in the following pages. 
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List/Nolist. The LIST option of a command allows the text of the UDC body to be listed on the 
standard list device after all parameters have been substituted. With the LIST option, errors are reported 
with a caret ( A ) under the error. Default is NOLI ST. An example is: 

TDPOFFLINE 

OPTION LIST 

FILE LP;DEV=EPOC;CCTL;ENV=LP2.ENV2680A.SYS 

RESUME 

When the UDC is used the text of the body is printed: 

; TDPOFFLINE 

FILE LP;DEV=EPOC;CCTL;ENV=LP2.ENV2680A.SYS 

RESUME 

READ pending 

Break/NoBreak. If NOBREAK is specified, the command will be nonBREAKable. If the NOBREAK option 
is not specified, all BREAKable commands within the UDC remain BREAKable. Default is BREAK. 

If a nonprogram command is broken, the UDC terminates. If a program command is broken and you use 
the : RESUME command to resume the program, the UDC will also resume. An exception to this occurs if 
the :SETCATALOG command is used while you are in the BREAK facility. In this case, the UDC will not 
be resumed. Refer to "USING THE :SETCATALOG COMMAND", this section. 

The UDC NOBREAK option overrides the CAUSEBREAK intrinsic. A program containing CAUSEBREAK will 
not BREAK if it is executed from a UDC that specifies the NOBREAK option. 

Suppose your UDC file contained the following: 

S 

SHOWJOB 

*«# 

SJ 

OPTION NOBREAK 

SHOWJOB 

««* 

If you use the "S" UDC, you could BREAK the listing as follows: 

:S 

JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 

#S55 EXEC 20 20 MON 2:49P FIELD. SUPPORT 

#S57 EXEC ** ibreaki pressed here. ** 

: RESUME 

COMMAND ONLY ALLOWED IN BREAK. (CIWARN 1686) ** I BREAK 1 aborts SHOWJOB.** 
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If you used the "SJ" UDC, you could not BREAK the listing. Enter: 
:SJ 
JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 



#S55 
#S57 



EXEC 
EXEC 



20 20 HON 2:49P FIELD. SUPPORT 

52 52 MON 2:50P BOB.DATAMGT 



2 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

2 EXEC; INCL 2 SESSIONS 

SUSP 
JOBFENCE= 2; JLIMIT= 2; SLIMIT= 16 



** [break] pressed here has no effect ** 



Logon/Nologon. The LOGON option specifies that the UDC will automatically executed when you logon. 
There are three levels in the UDC hierarchy: user, account, and system. One logon, at most UDC will be 
executed at each level. For users who have logon UDCs in each of the levels, the system logon UDC will 
execute first, then the account logon UDC, and finally the user logon UDC. If more than one logon UDC 
exists within any one particular level, only the first logon UDC will execute for that level without 
affecting the execution of logon UDCs at any other level. Default is NOLOGON. The first UDC at any 
level is that UDC named first in the :SETCATALOG command for that level. The UDC file ufileOl will be 
the first after the command :SETCATALOG uf ile01, ufileOl, ufileOl is executed. 

For example, suppose your UDC was: 



OPTION LOGON 

SHOWJOB 

««* 

When you logon, "S" automatically executes: 

: HELLO BARBARA. USERS 

HP3000 / MPE V G.03.00 (BASE G.03.00). MON, AUG 11, 1986, 8:43 AM 

JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 



#S55 
#S57 



EXEC 
EXEC 



20 20 MON 6:43A FIELD. SUPPORT 
52 52 MON 6:45A BARBARA. USERS 



2 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

2 EXEC; INCL 2 SESSIONS 

SUSP 
JOBFENCE= 6; JLIMIT= 7; SLIMIT= 40 



JUNE 1987 
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Help/Nohelp. The HELP subsystem may be used to obtain information about user defined commands, 
unless NOHELP is specified as an option. The default is HELP. Default is HELP. The MPE HELP subsystem 
does not contain a listing of UDCs. Therefore, entering the HELP subsystem first will defeat your purpose 
in trying to list the contents of a UDC. Instead, entering :HELP udcname forces the HELP subsystem to 
search out cataloged UDCs. 

The HELP subsystem will respond with a listing of the UDC: 

; HELP GRAPHOUT 

USER DEFINED COMMAND: 

GRAPHOUT 

FILE GRAPHOUT; DEV=EPOC 

RUN GRAPH. PUB. SYS 

The following example illustrates the result of an attempt to use the :HELP command on a UDC for 
which the NOHELP option has been specified: 

: HELP S ** The "S" UDC contains a NOHELP option ** 

Can't find anything under this command or in Table of Contents. 



NOTE 



If you specify both the NOLIST and NOHELP options and an 
error occurs, the error will be reported, but the line 
containing the error will not be echoed. 



Body 



As in the UDC header, any logical line in a UDC header may continue over more than one physical line 
and may contain as many as 320 characters. Each line to be continued must end with an ampersand (&) 
as the last nonblank character. The body portion of a UDC contains MPE commands which are executed 
when the UDC name is entered in place of an MPE command. In addition to MPE commands, you may 
also include other user defined commands (nested UDCs) and comment lines. You may not include any 
other noncommand material such as data for MPE subsystems or user programs. 

Several other restrictions also apply. The :REDO command is not allowed from within a UDC. Using 
:DATA, :JOB, or : HELLO within a UDC will cause your current job or session to log off, thereby 
terminating the UDC execution; no new job or session will be logged on. The body may also contain a 
parameter list which supplies values for the parameters defined in the UDC command header. Refer to 
'USING PARAMETERS" in this section. 
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USING THE :SETCATALOG COMMAND 

The :SETCATALOG command informs MPE that a specified file name contains user defined commands to 
be made available to the specified user, account, or system. The Command Interpreter then searches the 
file and establishes a directory of all commands contained in the file. The filename is stored in a system 
catalog of all UDC users ( COMMAND. PUB. SYS). 

If you want to carry out such a procedure for a file named MYUDC1, for example, enter: 

: SETCATALOO MYUDC1 

You may have more than one file to be entered into the directory. In this case, separate the files by 
commas. For example enter: 

: SETCATALOG KEYUDCS.UDCFILE 

The two files will be entered into the system catalog as a complete and separate set, and will replace any 
set of UDC files already existing in the catalog. 

You cannot use the : PURGE command on any UDC file that anyone is accessing. Nor can you use Editor 
to modify and keep a file under the same filename while anyone whose directory contains that file is 
logged on. Any attempt to do either of these two operations will result in an error message: "EXCLUSIVE 
VIOLATION". 

Entering :SETCATALOG with no parameters removes all your UDC files from the system UDC catalog. 
The files are not purged, but are deleted from the catalog. To purge or modify a particular UDC file, you 
must remove it from the system UDC catalog by issuing the :SETCATALOG command with a parameter 
list that does not include that particular UDC file. 

To re-enter UDC files into the catalog, enter the :SETCATALOG filename command for these files. 
Refer to the : SETCATALOG command in Section II. 

Removing UDCs with the :SETCATALOG command (for example, : SETCATALOG ; SYSTEM to remove system 
wide UDCs) has no immediate effect upon jobs/sessions that are still logged on, except for the job/session 
that enters the : SETCATALOG command. Another job/session may continue to access the canceled UDCs 
until that job or session terminates, or until each job or session forces the creation of a new UDC directory 
with a : SETCATALOG command. 

A user who does not have READ and LOCK access to a UDC file cannot use the : SETCATALOG command on 
that file, or logon while the file remains active in the system catalog. Therefore, security for the account 
and group in which the file resides must allow READ and LOCK access to all users (R , L ; ANY) at the 
account and system level. The default file access for the PUB group only gives READ access to users with 
AL, GL, or home group ( GU) capability. To override the default, you should use ": RELEASE filename" 
where filename is the system level UDC file. Refer to the : RELEASE command in Section II. 

If the UDC file has a lockword associated with it, that lockword may be specified when using the 
: SETCATALOG as in the following example: 

tSETCATALOG f ilel/lockword 
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The file and its associated lockword will then reside in COMMAND. PUB. SYS, so users need not know the 
lockword to logon or to access the UDC. If you fail to specify the lockword when using the :SETCATALOG 
command, MPE will prompt you for it. If you respond with an invalid lockword, the file will not be 
entered into COMMAND. PUB. SYS. 

The USER option of the :SETCATALOG command allows those with Account Manager (AM) capability to 
assign UDC catalogs to any user in their account. It also allows those with System Manager (SM) 
capability to assign UDC catalogs to any user in the system. Any changes will take effect the next time 
the user logs on. 

If the :SETCATALOG command is part of the user defined command, the :SETCATALOG command will be 
the last command executed in the UDC body; any subsequent commands in the UDC definition will not be 
executed. Further, if the UDC performing the :SETCATALOG is a nested UDC (i.e. invoked by another 
UDC), all levels of UDC execution are terminated, and you are returned to the Command Interpreter. 



If you execute a UDC that invokes a program or subsystem and you press [BREAKl while the program is 
running, you may execute a :SETCATALOG during the BREAK (with a direct command or through 
another UDC). Executing a : RESUME command will continue the program from the point at which the 
BREAK occurred. However, the UDC will fail to execute subsequent program/subsystem calls. 

For example, suppose you have a UDC which first calls the Editor subsystem, then performs a : SHOWOUT 
when you exit the Editor. You invoke the UDC and enter the Editor. While in the Editor, you press 
[BREAK) and enter the :SETCATALOG command to disassociate your UDC file from your account. The 
: RESUME command will return you to the Editor, but the : SHOWOUT will not occur when you exit. 

The system UDC catalog, COMMAND. PUB. SYS, must exist for the :SETCATALOG command to execute 
properly. If this file does not exist on your system, the System Manager or Supervisor must build it. The 
file should normally be built as a binary file with a record size of 20 words. The maximum number of 
records in the file COMMAND. PUB. SYS is determined by the sum of: 

the number of usernames with user level UDCs; plus 

the number of UDC catalog files specified for each user; plus 

the number of account level UDCs; plus 

the number of UDC catalog files for each account; plus 

one, if system level UDCs are in effect; plus 

the number of UDC catalog files specified for system UDCs. 

The System Manager could build a file for the system catalog in the following way: 

: BUI LP COMMAND. PUB ; REC=20 ,32 ; DISC=2000 

To secure COMMAND. PUB. SYS so that all system users may have UDCs, but only the System Manager may 
read or modify COMMAND . PUB . SYS. The System Manager should enter: 

: ALTSEC COMMAND. PUB; (X;ANY;R,L,W,A;CR) 

Doing so will provide EXECUTE (X) access to all users (ANY), and READ (R), LOCK (L), WRITE (W), and 
APPEND (A) access are available only to the Creating User (CR), in this case the System Manager. For 
more information on file security specifications, refer to the :ALTSEC command in Section II of this 
manual. 
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BUILDING AND MODIFYING A UDC FILE 



Once you have decided upon a command, or set of commands, that you would like to save, you may enter 
them into an ASCII disc file using the Editor. This file will have a default record length of 80 bytes for 
numbered files (standard Editor file), or 72 bytes for unnumbered files. You may create several such files, 
each consisting of one or more user defined commands. If a file contains more than one user defined 
command, the commands must be separated from each other by one line containing one or more asterisks, 
starting with an asterisk in the first column. 

The following is an example showing how to create user defined Commands with the Editor: 



: EDITOR 

HP32201A.7.12 EDIT/3000 MON, MAY 7, 1984, 3:36 PM 

(C) HEWLETT-PACKARD CO. 1982 

/ ADD 

1 S ** Header ** 

2 SHOWJOB ** List of Commands ** 



3 


LL 


/KEEP 


UDC1 


/DELETE ALL 


/ADD 

1 


L 


2 


LISTF 


3 


#*** 


4 


R 


5 


RESUME 


6 


LL 


/KEEP 


UDC2 


/EXIT 





** Separates UDCs ** 



END OF SUBSYSTEM 
: SETCATALOG UDC1 ,UDC2 

After setting the catalog, log off. Then log back on. Now you can use the UDCs you created for 
: SHOWJOB, : LISTF, and : RESUME. Using "S" to invoke : SHOWJOB is illustrated below. 



JOBNUM STATE IPRI JIN JLIST 



INTRODUCED JOB NAME 



#S55 
#S57 



EXEC 
EXEC 



20 20 MON 2:49P FIELD. SUPPORT 

52 52 MON 2:50P BOB.DATAMGT 



2 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

2 EXEC; INCL 2 SESSIONS 

SUSP 
JOBFENCE= 2; JLIMIT= 2; SLIMIT= 16 



The Editor can be used to modify commands stored in a UDC file if that file is not being accessed. Note, 
however, that once a UDC file has been entered into the system UDC catalog with the :SETCATALOG 
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^"! I ?f^ , i t , Can f 0t *! modified and ke Pt under the same name while any user whose directory contains 
that UDC file is logged on. 

UDCfU^To mod^UDCI 4 " ^ ^ *** ^ *' **** UDC1 ' ** ^""^ ° n the PreVi ° US me ' aS y0Ur 

; SHOWCATALOG 

UDC1.SMR.0SE 

S USER 

: EDITOR 

HP32201A.7.12 EDIT/3000 MON, MAY 7, 1984, 3:36 PM 
(C) HEWLETT-PACKARD CO. 1982 
/T UDC1 
/A 1.1 

1.1 OPTION NOBREAK 

1.2 ZZ 

• • • 

/K UDC1 

--F-I-L-E- — I-N-F-0-R-H-A-T-I-0-N-— D-I-S-P-L-A-Y-- 
I ERROR NUMBER: 90 RESIDUE: I 

I BLOCK NUMBER: NUMREC: | 

»41«FAILURE TO OPEN KEEP FILE (90) 

EXCLUSIVE VIOLATION: FILE B EING ACCESSED (FSERR 90) 

/ ** (BREAK I pressed here. ** 

: SETCATALOO ** File disassociated from system UDC catalos. ** 

: RESUME 

READ PENDING 

K UDC1 

UDC1 ALREADY EXISTS - RESPOND YES TO PURGE OLD AND KEEP NEW 

PURGE OLD?Y 

/E 

END OF SUBSYSTEM 

:SETCATALOG UDC1 



DETAILS OF UDC OPERATION 

UDCs are initialized at logon, provided that the user, account, or system level UDCs exist and have been 
associated by the :SETCATALOG command, or whenever the user executes a :SETCATALOG command The 
system file, COMMAND. PUB. SYS, holds the UDC filenames associated with each user, account, and system 
J2JSV?" 1 mcludes P° intcrs to «" files in which the UDCs are defined. At initialization time, all the 
UDC files needed by the user are opened, and a UDC directory is created for the user. 
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The position of one UDC in the directory determines which other UDCs can call it and which others it 
can call. The UDC hierarchy imposed by the system depends on how the UDCs entered into the directory 
are found in the file. The files are opened and scanned in the order they appeared in the last :SETCATALOG 
command for that UDC level. If, for example, the UDC files CAT1 and CAT" are enabled with 
rSETCATALOG CAT1, CAT2, then any UDCs in CAT1 may call any UDCs in CAT2. The reverse is not true: 
UDCs in CAT2 cannot call UDCs in CAT1. All user UDCs are entered into the directory first, then all 
account UDCs, and all system UDCs are entered last. 

If the UDC file has a lockword, you do not need to know the lockword to logon or to access the UDC, 
since the lockword is kept in COMMAND. PUB. SYS. The System Manager can release COMMAND. PUB. SYS, so 
that all system users may access and execute the UDCs. But only the System Manager may read or modify 
the COMMAND. PUB. SYS by entering the : ALTSEC command. For more information, refer to "USING THE 
:SETCATALOG COMMAND" in this section. 

When you are in the Command Interpreter (CI) and have a colon prompt (:), or a remote prompt (#), you 
can execute a UDC by entering the command name, followed by a parameter list (if needed). The UDC 
directory is scanned for that command, starting at the beginning of the directory. If the command is 
found, the UDC body for that command is read one line at a time, and parameters are substituted into the 
line where appropriate. 

The CI is re-entered at a special internal entry point. This UDC entry is treated as a new command 
string, and is handled much the same as all other command strings: the UDC directory is scanned for a 
UDC that matches the command string. This time, however, the UDC directory scan begins at the 
directory entry that follows the UDC currently being executed. In this way, UDCs can call other UDCs as 
long as the called UDC is defined after the UDC being executed. If the Command Interpreter fails to find 
a match for the command string in the UDC directory, it then tries to match the command string with an 
MPE command. This implementation allows some UDCs to call other UDCs, but does not allow any kind 
of UDC recursion. This linear scan of the UDC directory is the heart of UDC invocation. This particular 
scan will allow UDCs with the same name to be executed at different times. 

Note that the names of UDCs may be composed of alphanumeric characters, but must begin with an 
alphabetic character. MPE commands, however, contain only alphabetic characters. A string such as 
"SH0WDEV6" is treated first as a UDC, because the last character is numeric. If no UDC exists under that 
name, the MPE command :SHOWDEV is passed to the parameter. Normal MPE command syntax requires a 
space between the command and the parameter. The coincidence of names in this example is unusual and 
produces unexpected results: "SHOWDEV" is a valid MPE command, and MPE is capable of separating the 
command from the parameter and executing them accordingly. 



NESTING UDCs 

User defined commands can be nested; that is, they can be so defined that entering one UDC will cause 
several UDCs to execute. For example: 

DOALL 

L 

S 

L 
LISTF 

S 

SHOWJOB 
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If the preceding set of UDCs is entered into a UDC directory, then each time DOALL is entered, the MPE 
commands :LISTFand : SHOWJOB will execute. 

Note, however, that a UDC can call another UDC only if the UDC being called is defined after the calling 
UDC. 

If, in the example, DOALL is put in the UDC file after the L and S user defined commands, the UDC DOALL 
will not execute, and an error message will result: 

L 

LISTF 

««* 

S 

SHOWJOB 

««« 

DOALL 

L 

S 

When the command DOALL is entered, the UDCs that it calls will not be found: 

; DOALL 
L 

UNKNOWN COMMAND NAME. (CI ERR 975) 

System level UDCs are global to account level UDCs, which in turn are global to user level UDCs. This 
means that an account level UDC can call a system level UDC, and a user level UDC can call either 
account or system level UDCs. 

If a system and a user level UDC have the same name, and an account level UDC calls a UDC by this 
name, the system level UDC will be called instead of the user level UDC, because the system level UDC is 
global to the user level UDCs. 



ERRORS IN A USER DEFINED COMMAND 

A user defined command contains an error if the execution of an MPE command or a user defined 
command within the body of the UDC results in an error; or if the expansion of the UDC parameters 
results in an error. If an error or warning occurs as a result of executing a UDC, MPE will: 

1. Print the appropriate error message, always. 

2. Print a caret ( ~ ) pointing to the error, Unless the NOHELP 

option is specified in the UDC. 

3. Print the line in which the error occurs, unless the NOHELP 
and NOLI ST options are specified. 
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Every time a user logs on, the system initializes the user's UDC directory, as discussed earlier in this 
section. If an illegal UDC is encountered during initialization, or if the UDC file cannot be opened 
(perhaps it has been purged), only the UDC level in which the error occurs will fail to be initialized. If, 
for example, the user level UDC file encounters an error at logon, the user will still have access to account 
and system level UDCs. Similarly, if an account level UDC encounters an error at logon, the user will still 
have access to user and system level UDCs. 

If you anticipate difficulty from a particular command line, you may insert a : CONTINUE command in 
the line immediately preceding the potentially troublesome line. 

The CONTINUE command permits the MPE to bypass the error and proceed with subsequent command 
lines. In a job, a UDC that generates an error will terminate the job, unless the UDC contains a 
: CONTINUE command at one of the current nesting levels. 

Consider the following UDC file: 

A 

LISTF A€ 

B 

SHOWJOB 

»«« 

B 

BUILD FILEX;CODE=XXXX 

SHOWTIME 

«*« 

Suppose the UDC A is executed: 

:A 

FILENAME 

APPA APPB APPB1VE APPB2 APPB2VE APPB3 

APPB3VE 

BUILD FILEX;CODE=XXXX 

UNKNOWN FILE CODE TYPE. (CIERR 253) 

UDC B contains an error because the : BUI LD command contains an invalid file code. Therefore, the UDC 
B terminates and the : SHOWTIME following the : BUILD command is not executed. Because the execution 
of UDC B results in an error, : SHOWJOB in UDC A is not executed. 

A :CONTINUE may be placed before the : FILE command in UDC B to allow both UDCs to execute 

A 

LISTF Ag 

B 

SHOWJOB 
«** 

B 

CONTINUE 

BUILD FILEX;CODE=XXXX 

SHOWTIME 

*«« 
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Suppose the UDC A is executed: 

:A 

FILENAME 

APPA APPB APPB1VE APPB2 APPB2VE APPB3 
APPB3VE 

BUILD FILEX;CODE=XXXX 

UNKNOWN FILE CODE TYPE. (CIERR 253) 
MON, MAY 7, 1984, 7:39 AM 

JOBNUM STATE IPRI JIN JLIST INTRODUCED JOB NAME 

#S118 EXEC 20 20 MON 9:02P OPERATOR. SYS 
#S48 EXEC QUIET 223 223 MON 1:51P TEXT. USER 
#S69 EXEC 179 179 MON 2:31P SUPPORT.DOC 

3 JOBS: 

INTRO 

WAIT; INCL DEFERRED 

1 EXEC; INCL 3 SESSIONS 
SUSP 

JOBFENCE= 2; JLIMIT= 5; SLIMIT= 40 



USING PARAMETERS 

The name given to a parameter in the header of a UDC is the formal name by which the parameter is 
known to the commands in the body of the UDC. "Required" parameters are those for which no default 
values are supplied in the command header. If a value for a required parameter is not supplied in the 
parameter list, an error is reported, and the UDC is not executed. If there are no required parameters in 
the UDC header, a parameter list does not have to be supplied when the command is executed. 

Types of Parameters 

A "keyword" parameter is one in which the formal name of the parameter appears in the parameter list 
exactly as it appears in the parameter declaration. The Command Interpreter makes no distinction, 
though, between upper and lower case alphabetic characters. A "keyword" parameter may appear in any 
position or in any order in the parameter list. 

A "positional" parameter requires the substitution of a name or value in the parameter list in place of the 
formal name in the parameter declaration. "Positional" parameters must appear in the parameter list in 
the same relative position occupied by the formal name in the parameter declaration. 
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When supplying values for UDC parameters you can use either keyword parameters or positional 
parameters, but not both at the same time. MPE permits both decimal and octal numbers as command 
parameters. Octal numbers are preceded by a percent sign ( %). The following are examples of different 
parameter lists for a UDC named Z, with this header: 

Z PARM1,PARM2=FTN06,PARM3="REC=40, 16, F, ASCII" 

EXAMPLE 1: 

:Z FTN05 

The specified required parameter PARM1 would take the value of FTN05; PARM2 would default to FTN06, 
and PARM3 would default to REC=40,16,F,ASCII. 

EXAMPLE 2: 

:Z FTN05,FTN77 

PARM1 would take the value FTN05, and PARM2 the value FTN77. The default value for PARM2 would not 
be used because the call contained a new value. The default value ( REC=40, 1 6, F, ASCI I) would be used 
for PARM3 because PARM3 was not specified. Both FTN05 and FTN77 are positional parameters because 
they substitute for PARM1 and PARM& 

EXAMPLE 3: 

: Z PARM2=FTN77 , PARM 1 =FTN05 

Example 3 illustrates entering the command Z with keyword parameters. Note that this call is 
identical in its effect to the call in Example 2. PARM3 would take its default value (REC=40, 
16, F, ASCII). 

EXAMPLE 4: 

:Z FTN05,,"REC=-88" 

Example 4 illustrates double quotation marks (" ") to delimit a parameter when that parameter 
contains embedded blanks or special characters. Also note that the second parameter is not specified 
(position is denoted by the adjacent commas), thus the default value FTN06 is used for PARM2, and 
(REC=-88 ,16, F , ASCI I) is used for PARM3. 

The body of the user defined command follows the header and specifies the MPE commands that the user 
defined command Z is to execute: 

FILE INPUT=!PARM1,0LD 

FILE LISTFILE=!PARM2,NEW;!PARM3;DISC=1000 

RUN ABC 

Thus, the complete user defined command Z is: 

Z PARM1,PARM2=FTN06,PARM3="REC=-40, 16, F, ASCII" ** Header ** 

FILE INPUT=!PARM1,OLD ** Body ** 

FILE LISTFILE=!PARM2,NEW;!PARM3;DISC=1000 
RUN ABC 
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Parameter Delimiters 

Placing an exclamation mark (!) before a formal parameter name appearing in the body of the command 
instructs MPE to substitute the value of that parameter into the command. If a parameter name does not 
follow the exclamation point, then the string is retained literally, with no error reported to the user. 

The first line of the UDC body tells MPE that ! PARM1 will take the value of an input file to be specified 
later: 

FILE INPUT=!PARM1,0LD 

Similarly, the second line of the UDC body informs MPE that you wish to substitute an output file called 
FTN06 (a default value in this example) for ! PARM2: 

FILE LISTFILE=!PARM2,NEW;!PARM3;DISO1000 

Notice that the command body of UDC Z contains only the MPE commands :FILE and :RUN, and 
parameters for these commands: 

FILE INPUT=!PARM1,0LD ** Body of UDC Z ** 

FILE LISTFILE=!PARM2,NEW;!PARM3;DISC=1000 
RUN ABC 

In the UDC, PARM1 is a required parameter (it has no default value), so its value must be supplied in the 
parameter list. The parameters PARM2 and PARM3, however, do have specified default values and so are 
optional. They will be passed to the command body either as default values, or as values you enter in the 
parameter list with the commands: 

Z PARM1,PARM2=FTN06,PARM3="REC=40, 16, F, ASCII" 
FILE INPUT=!PARM1,0LD 

FILE LISTFILE=!PARM2,NEW;!PARM3;DISC=1000 
RUN ABC 

Note that the parameters DISC=1000 (for the :FILE LISTFILE command) and ABC (for the :RUN 
command) cannot be changed by the user -entered command call. 

An exclamation mark in a UDC normally signifies a parameter name. There might be occasions when 
you want to retain the exclamation mark without signifying a parameter name. Doubling the 
exclamation mark (! !) prevents MPE from treating the characters that follow as a parameter name. An 
odd number of exclamation marks preceding a set of characters causes MPE to expect a value to substitute 
for the character set. An even number of exclamation marks preceding a set of characters tells MPE that 
the character set is not a parameter and tells it not to attempt a value substitution: 

TESTUDC PARM 
OPTION LIST 
COMMENT" ! ! PARM" 
COMMENT"!!! PARM" 

If the user executes this UDC with ": TESTUDC ABC", the two comments will be printed as: 

COMMENT "!!PARM" 
COMMENT "!!ABC" 



3-15 



User Defined Commands 

The UDC parameter can be delimited by the use of double quotes ("). Doing so allows the user to insert 
the parameter into the middle of another string. The quotes are not part of the command, although other 
blank or nonblank characters within the quotation marks may be. Imagine, for example, having 
application program to compile and prepare daily: 

SOURCE USL PROGRAM 

APPL1SRC APPL1USL APPL1 

You could easily create s UDC to combine the steps to prepare any of the above three source files into a 
program file (note the commented delimiters on the parameters): 

COMPAPPL MODULE 

OPTION LIST 

PURGE APPLtMOPULE ** Blank ** 

SPL APPL!"MODULE"SRC, APPL!"MODULE"USL ** Quotes ** 

PREP APPL!"MODULE"USL, APPL! MODULE ;"PMAP ** Semicolon ** 

SAVE APPL! MODULE ** Blank ** 

After adding the COMPAPPL UDC to the catalog, you may compile and prepare APPL 1 SRC by entering: 

; COMPAPPL 1 

Entering this UDC is the same as entering the following MPE commands: 

PURGE APPL1 

SPL APPL1SRC, APPL1USL 
PREP APPL1USL, APPL1; PMAP 
SAVE APPL1 



INCREASING UDC FUNCTIONALITY 

UDCs can perform functions considerably more complex than those already covered in this section by 
including sophisticated command sequences within the body of the UDC. In the following example, the 
UDC Y2 contains the command sequence normally entered to initiate a remote session: 

Y2 WHO=" USER/PASS. ACCT " 

DSLINE Y2 

REMOTE HELLO !WHO ** Remote logon to Y 2. ** 

REMOTE 

Using UDCs in this way can save you from typing frequently used command sequences. Using regular 
characters, control characters and escape sequences in UDCs allows you to build and control inverse video 
fields on the terminal. Softkey and terminal key functions can also be manipulated with advanced UDCs. 
The terminal keys and softkeys can then be dynamic throughout your session. If you use Editor functions, 
for example, you can establish a UDC to program the softkeys to execute Editor commands. 
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USING UDCs WITH JOB CONTROL WORDS 



UDCs may be used with Job Control Words (JCWs) to further increase UDC functionality. UDCs that use 
JCWs within their structure, for example, are useful for monitoring and maintaining the status of your 
session. The following example of an advanced UDC expands upon the idea of using UDCs to initiate 
remote sessions. It incorporates a JCW, Y 1 JCW, which has been previously set to zero in a logon UDC, to 
first check whether you already have a remote session. 



CHECKY1 WHO ="USER.ACCT" 
IF Y1JCW = THEN 



** Check on current value of YJCW1. ** 



DSLINE Y1 

REMOTE HELLO fWHO 



** Remote logon. ** 



SET JCW Y1JCW = 1 



** YUCWissetto 1. ** 



ENDIF 



If you later tried to initiate a remote session on Y1 using the above UDCs, the value of the JCW Y1JCW 
would be 1. The IF block would not execute, and no new session would be initiated. 

For more information on Job Control Words, refer to the : SET JCW and : SHOWJCW commands in Section II 
of this manual, as well as the MPE V Intrinsics Reference Manual (32002-9001 8). 



3-17/3-18 



TERMINAL 
TYPES 


DESCRIPTION 


6* 


HP 2762A/B (General Electric Terminet 300 or 1200), or Data 
Communications terminal, Model B (10/15/30/120 cps) with Paper Tape 
Reader/Punch, Option 2. 

NOTE: This terminal must be equipped for ECHO PLEX. 


9* 


HP 2 1 65A Terminal (Beehive MiniBee) (10/1 5/30/60/1 20/240 cps). 


10* 


HP 2382A, 39x, 262x, and 264x or HP Personal Computer running on 
Terminal Emulation Mode. 


12* 


HP 2645K Katakana/Roman Data Terminal. 


13* 


Message switching network or other computer. 


14 


Multipoint Terminal. 


15* 


HP 2635A Printing Terminal. 8 -bit protocol (for second character set). 


16* 


HP 2635A Printing Terminal. 7 -bit protocol (standard character set). 


18* 


Non-HP devices. Only provides XON/XOFF protocol data -handling. All ap- 
plication printers. 


19* 


HP 26 3 IB or HP 261 3B-compatible Remote Spooled Printers. 


20* 


8 -bit Spooled Serial Printer (not supported with subtype 1 5). Not supported 
with ATC (Series II/III). 


21* 


Spooled Serial Printer with embedded escape sequences allowed. HP263 IB or 
HP 2 6 3 IB -compatible printers. Not supported with ATC (Series II/III). 


22 


8 -bit Spooled Serial Printer with embedded escape sequences allowed (not 
supported with subtype 15). HP 263 IB or 26 3 IB-compatible printers. Not 
supported with ATC (Series II/III). 


TTCL18 


HP2687A (MPE G. 01. 00 or later) 


TTPCL19 


7 bit PCL Serial Spooled Printers. 


TTPCL22 


8 bit PCL Serial Spooled Printers. 



* = Terminal Types supported with ADCC (Series 30/33). 

For further information refer to the Fundamental Communications Handbook (5957-4634). 
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DESIGNATORS 



APPENDIX 



B 



COMMAND 


PARAMETER 


FORMAL FILE DESIGNATOR 


: BASIC 


comrandfile 
input file 
listfile 


BASCOM 

BASIN 

BASLIST 


: BASICOMP 


textfile 

uslfile 

listfile 


BSCTEXT 

BSCUSL 

BSCLIST 


: BASIC GO 


textfile 
listfile 


BSCTEXT 
BSCLIST 


:BASICPREP 


textfile 
listfile 


BSCTEXT 
BSCLIST 


rBBASIC 


comrandfile 

inputfile 

listfile 


BASCOM 

BASIN 

BASOUT 


:BBASICOMP 


in file 

uslfile 

listfile 


BBCIN 

BBCUSL 

BBCLIST 


: BBASICGO 


in file 
listfile 


BBCIN 
BBCLIST 


: BBASICPREP 


in file 
listfile 


BBCIN 
BBCLIST 


: COBOL 


textfile 
uslfile 
listfile 
masterfile 
new file 


COBTEXT 

COBUSL 

COBLIST 

COBMAST 

COBNEW 


:COBOLGO 


textfile 
listfile 
masterfile 
new file 


COBTEXT 
COBLIST 
COBMAST 
COBNEW 


: COBOL PREP 


textfile 
listfile 
masterfile 
new file 


COBTEXT 
COBLIST 
COBMAST 
COBNEW 



B-l 



Subsystem Formal File Designators 



COMMAND 


PARAMETER 


FORMAL FILE DESIGNATOR 


: COBOL I I 


text file 


COBTEXT 




uslfile 


COBUSL 




list file 


COBLIST 




masterfile 


COBMAST 




new file 


COBNEW 




workspacename 


COBWKSP 


:COBOLIIGO 


text file 


COBTEXT 




listfile 


COBLIST 




masterfile 


COBMAST 




new file 


COBNEW 




workspacename 


COBWKSP 


:COBOLIIPREP 


text file 


COBTEXT 




prog file 


COBPROG 




listfile 


COBLIST 




masterfile 


COBMAST 




new file 


COBNEW 




workspacename 


COBWKSP 


: EDITOR 


listfile 


EDTLIST 


: FORTRAN 


text file 


FTNTEXT 




uslfile 


FTNUSL 




listfile 


FTNLIST 




masterfile 


FTNMAST 




new file 


FTNNEW 


:FORTGO 


text file 


FTNTEXT 




listfile 


FTNLIST 




masterfile 


FTNMAST 




new file 


FTNNEW 


:FORTPREP 


text file 


FTNTEXT 




listfile 


FTNLIST 




masterfile 


FTNMAST 




new file 


FTNNEW 


:FTN77 (FORTRAN 77) 


text file 


FTNTEXT 




uslfile 


FTNUSL 




listfile 


FTNLIST 


:FTNGO 


text file 


FTNTEXT 




listfile 


FTNLIST 


:FTNPREP 


text file 


FTNTEXT 




prog file 


FTNPROG 




listfile 


FTNLIST 


: PASCAL 


text file 


PASTEXT 




uslfile 


PASUSL 




listfile 


PAS LI ST 
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COMMAND 


PARAMETER 


FORMAL FILE DESIGNATOR 


: PASCALGO 


text file 
listfile 


PASTEXT 
PASLIST 


:PASCALPREP 


text file 
listfile 


PASTEXT 
PASLIST 


:PREP 
: PREPRUN 


PMAP 


SEGLIST 


: PREPRUN 
:RUN 


LMAP 


LOADLIST 


: RESTORE 


SHOW 


SYSLIST 


:RPG 


text file 
uslfile 
listfile 
masterfile 
new file 


RPGTEXT 
RPGLIST 
RPGHAST 
RPGNEW 


:RPGGO 


text file 
listfile 
masterfile 
newfile 


RPGTEXT 
RPGLIST 
RPGMAST 
RPGNEW 


tRPGPREP 


text file 
listfile 
masterfile 
newfile 


RPGTEXT 
RPGLIST 
RPGMAST 
RPGNEW 


:SEGMENTER 


listfile 


SEGLIST 


:SPL 


text file 

uslfile 

listfile 

masterfile 

newfile 


SPLTEXT 

SPLUSL 

SPLLIST 

SPLMAST 

SPLNEW 


:SPLGO 


text file 
listfile 
masterfile 
newfile 


SPLTEXT 
SPLLIST 
SPLMAST 
SPLNEW 


:SPLPREP 


text file 
listfile 
masterfile 
newfile 


SPLTEXT 
SPLLIST 
SPLMAST 
SPLNEW 
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COMMAND 


PARAMETER 


FORMAL FILE DESIGNATOR 


: STORE 
: RESTORE 


SHOW 


SYSLIST 


:VINIT 


listfile 


VINLIST 
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SNEWPASS, 1-15 
$NULL, 1-15 
SOLDPASS, 1-15 
$STDIN, 1-14 
SSTDINX, 1-14 
SSTDLIST, 1-15 



ALLOCATE Command, 2-18 
ALLOW Command, 2-20 
ALTACCT Command, 2-22 
Alternative Execution Sequence, 2-113 
ALTGROUP Command, 2-27 
ALT JOB Command, 2-31 
ALTLOG Command, 2-33 
ALTSEC Command, 2-35 
ALTSPOOLFILE Command, 2-37 
ALTUSER Command, 2-39 
ALTVSET Command, 2-42 
ASSOCIATE Command, 2-44 
AUTOALLOCATE Command, 2-45a 



( ):COMMAND LOGON Command, 2-7 



B 



*(File Back Referencing), 1-14 



ABORT Command, 2- 1 1 

ABORTIO Command, 2-12 

ABORTJOB Command, 2-14 

Abort? Prompt, 1-12 

Aborting a Program, 1-13 

Aborting an Operation, 2-11 

ACCEPT Command, 2- 1 6 

Access File Command Parameters, 2-130 

Accessing 

BASIC Interpreter, 2-46 
BBASIC Interpreter, 2-54 
FCOPY Subsystem, 2- 1 20 
HELP Subsystem, 2-167 
MPE Segmenter, 2-307 

Account 

Name, at Logon, 2-7, 2-163, 2-175 
in a JOB Command, 2-172 

Acquiring RIN, 2-155 



Back Referencing Files, 1-14 
BASIC Command, 2-46 
BASIC Programs 

Compiling, 2-48, 2-50, 2-52, 2-58, 2-60 

Executing, 2-48, 2-56 

Interpreting, 2-46 

Preparing, 2-48, 2-52, 2-56, 2-60 
BASICGO Command, 2-48 
BASICOMP Command, 2-50 
BASICPREP Command, 2-52 
Batch Job 

Initiating, 2-172 

Spooling, 1-9,2-319,2-382 

Submitting, 2-177 
BBASIC Command, 2-54 
BBASIC Programs 

Compiling, 2-56, 2-58 

Interpreting, 2-54 
BBASICGO Command, 2-56 
BBASICOMP Command, 2-58 
BBASICPREP Command, 2-60 
BREAK Key 

Interrupting Commands, 1-10 

Suspending Program Execution, 1-12 
BREAKJOB Command, 2-62 
BUILD Command, 2-63 
BYE Command, 2-70 
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CACHECONTROL Command, 2-71 

CHANGELOG Command, 2-73 

COBOL Command, 2-75 

COBOL Programs 

Compiling, 2-75, 2-77, 2-79 
Executing, 2-77 
Preparing, 2-77, 2-79 

COBOLGO Command, 2-77 

COBOLII Command, 2-82 

COBOLIIGO Command, 2-84 

COBOLIIPREP Command, 2-86 

COBOLPREP Command, 2-79 

Command Errors, 1-10 

COMMAND LOGON Command, 2-7 

Commands 

Breakable, 1-12 
Comments, Inserting, 2-89 
Correcting Entry of, 2-262 
Elements, 1-4 
Execution at Logon, 1-8 
Execution From a Program, 1-9 
How to Edit (:REDO), 2-262 
How to Enter, 1-7 
Interrupting Execution of, 1-10 
Interrupting Nonprogram, 1-12 
Interrupting Program, 1-12 
Name, 1-4 

NonBREAKable, 1-12 
Nonprogram, 1-12 
Parameter List, 1-4 
Sequence Numbers, 1-9 
Commands, List of 
: ABORT Command, 2-11 
:ABORTIO Command, 2- 1 2 
=ABORTIO Command, 2-12 
:ABORTJOB Command, 2- 1 4 
■ABORTJOB Command, 2-14 
ACCEPT Command, 2-16 
ALLOCATE Command, 2- 1 8 
ALLOW Command, 2-20 
ALTACCT Command, 2-22 
ALTGROUP Command, 2-27 
ALTJOB Command, 2- 3 1 
ALTLOG Command, 2-33 
ALTSEC Command, 2-35 
ALTSPOOLFILE Command, 2-37 
ALTUSER Command, 2- 39 



ALTVSET Command, 2-42 
ASSOCIATE Command, 2-44 
AUTO ALLOCATE Command, 2- 4 5a 
:BASIC Command, 2-46 
BASICGO Command, 2-48 
:BASICOMP Command, 2-50 
:BASICPREP Command, 2-52 
BBASIC Command, 2-54 
BBASICGO Command, 2-56 
BBASICOMP Command, 2-58 
BBASICPREP Command, 2-60 
:BREAKJOB Command, 2-62 
BUILD Command, 2-63 
BYE Command, 2-70 
CACHECONTROL Command, 2-71 
:CHANGELOG Command, 2-73 
COBOL Command, 2-75 
COBOLGO Command, 2-77 
COBOLII Command, 2-82 
:COBOLIIGO Command, 2-84 
COBOLIIPREP Command, 2-86 
rCOBOLPREP Command, 2-79 
:COMMAND LOGON Command, 2-7 
:COMMENT Command, 2-89 
CONSOLE Command, 2-90 
CONTINUE Command, 2-92 
DATA Command, 2-93 
DEALLOCATE Command, 2-96 
DEBUG Command, 2-97 
:DELETESPOOLFILE Command, 2-98 
DISALLOW Command, 2-100 
DISASSOCIATE Command, 2- 1 02 
DISCRPS Command, 2-103 
DISMOUNT Command, 2-104 
DOWN Command, 2- 1 05 
DOWNLOAD Command, 2- 1 07 
DSTAT Command, 2-109 
EDITOR Command, 2-111 
ELSE Command, 2-113 
:ENDIF Command, 2-114 
:EOD Command, 2-115 
:EOF Command, 2-118 
EOJ Command, 2-119 
:FCOPY Command, 2-120 
:FILE Command, 2-122 
FOREIGN Command, 2-136 
:FORTGO Command, 2-1 38 
:FORTPREP Command, 2-140 
FORTRAN Command, 2- 1 34, 2- 1 43 
FREERIN Command, 2-145 
FTN Command, 2-146 
;FTNGO Command, 2-148 
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:FTNPREP Command, 2- 1 50 
:FULLBACKUP Command, 2-1 52 
:GETLOG Command, 2-153 
:GETRIN Command, 2-155 
:GIVE Command, 2-157 
:HEADOFF Command, 2-159 
:HEADON Command, 2-160 
:HELLO Command, 2-161 
:HELP Command, 2-167 
.IF Command, 2-170 
JOB Command, 2-172 
:JOBFENCE Command, 2-177 
rJOBPRI Command, 2-179 
:JOBSECURITY Command, 2-1 80 
:LDISMOUNT Command, 2-181 
:LIMIT Command, 2-1 82 
:LISTACCT Command, 2-184 
:LISTF Command, 2-188 
:LISTGROUP Command, 2-203 
:LISTLOG Command, 2-206 
rLISTUSER Command, 2-208 
:LISTVS Command, 2-211 
rLMOUNT Command, 2-214 
:LOG Command, 2-216 
=LOGOFF Command, 2-217 
:LOGON Command, 2-218 
rMOUNT Command, 2-219 
:NEWACCT Command, 2-221 
:NEWGROUP, 2-225 
:NEWUSER Command, 2-228 
:NEWVSET Command, 2-231 
:OPENQ Command, 2-233 
:OUTFENCE Command, 2-234 
rPARTBACKUP Command, 2-236 
:PASCAL Command, 2-238 
rPASCALGO Command, 2-240 
:PASCALPREP Command, 2-242 
PASSWORD, 243a 
:PREP Command, 2-244 
:PREPRUN Command, 2-247 
:PTAPE Command, 2-252 
:PURGE Command, 2-253 
:PURGEACCT Command, 2-255 
.PURGEGROUP Command, 2-257 
:PURGEUSER Command, 2-259 
:PURGEVSET Command, 2-260 
:RECALL Command, 2-26 1 
=RECALL Command, 2-261 
:REDO Command, 2-262 
:REFUSE Command, 2-264 
:RELEASE Command, 2-265 
:RELLOG Command, 2-268 
:RENAME Command, 2-269 



:REPLY Command, 2-271 

=REPLY Command, 2,7 1 

:REPORT Command, 2-273 

:RESETDUMP Command, 2-279 

rRESTORE Command, 2-280 

:RESUME Command, 2-288 

:RESUMEJOB Command, 2-289 

:RESUMELOG Command, 2-290 

:RESUMESPOOL Command, 2-291 

:RPG Command, 2-293 

.RPGGO Command, 2-295 

:RPGPREP Command, 2-297 

:RUN Command, 2-300 

SAVE Command, 2-304 

SECURE Command, 2-306 

SEGMENTER Command, 2-307 

SET Command, 2-309 

SETCATALOG Command, 2-310 

SETDUMP Command, 2-313 

SETJCW Command, 2-315 

SETMSG Command, 2-320 

SHOW ALLOC ATE Command, 2- 3 20a 

SHOW ALLOW, 2-321 

SHOWCACHE, 2-322 

SHOWCATALOG Command, 2-324 

SHOWCOM, 2-326 

SHOWDEV Command, 2-328 

SHOWIN Command, 2-331 

SHOWJCW Command, 2-335 
SHOWJOB Command, 2-337 
SHOWLOG, 2-342 
SHOWLOGSTATUS Command, 2-343 
SHOWME Command, 2-345 
SHOWOUT Command, 2-347 
SHOWQ Command, 2-352 
SHOWTIME Command, 2-354 
SHUTDOWN Command, 2-355 
SHUTQ Command, 2-357 
SPEED Command, 2-358 
SPL Command, 2-360 
SPLGO Command, 2-362 
SPLPREP Command, 2-364 
STARTCACHE Command, 2-367 
STARTSESS Command, 2-368 
STARTSPOOL Command, 2-372 
STOPCACHE Command, 2-374 
STOPSPOOL Command, 2-375 
STORE command, 2-377 
STREAM Command, 2-382 
STREAMS Command, 2-388 
SUSPENDSPOOL Command, 2-390 
SWITCHLOG Command, 2-391 
SYSDUMP Command, 2-393 
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:TAKE Command, 2-396 
:TELL Command, 2-397 
:TELLOP Command, 2-399 
:TUNE Command, 2-400 
:UP Command, 2-403 
:VINIT Command, 2-404 
:VMOUNT Command, 2-407 
:VSUSER Command, 2-411 
:WARN Command, 2-412 
:WELCOME Command, 2-413 

Commands, Listing of Temporary, 2-197 

COMMENT Command, 2-89 

Compiling 

BASIC Programs, 2-48, 2-50, 2-52, 2-58 
BBASIC Programs, 2-56, 2-58, 2-60 
COBOL Programs, 2-75, 2-77, 2-79 
COBOLII Programs, 2-82, 2-84, 2-86 
FORTRAN Programs, 2-138, 2-140 

2-143,2-146 
PASCAL Programs, 2-238, 2-240, 2-241 
RPG Programs, 2-293, 2-295, 2-297 
SPL Programs, 2-360, 2-362, 2-364 

CONSOLE Command, 2-90 

Continuation Character, 1-8 

CONTINUE Command, 2-92 
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DATA Command, 2-93 
Date, How to Display, 2-354 
DEALLOCATE Command, 2-96 
DEBUG Command, 2-97 
DELETESPOOLFILE Command, 2-98 
Deletion of $STDLIST, 2-309 
Delimiters 

Data, 2-115 

Parameter, 1-4, 3-15 
Device 

Operator Control, 2-44 

Status, How to Display, 2-328, 2-347 

User Control, 2-102 
Devicefile 

Changing Identity, 2-269 

Data Output, 2-9 3 

Input, How to Access, 2-331 

Output, How to Access, 2-347 

State, 2-331, 2-347 
DISALLOW Command, 2-100 
DISASSOCIATE Command, 2-102 
Disc Drive Status, 2-109 



DISMOUNT Command, 2-104 
DOWN Command, 2-105 
DOWNLOAD Command, 2- 1 07 
DSTAT Command, 2-109 
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Editing Commands, 1-10 
,2-262 

EDITOR Command, 2-111 

Elements of a Command, 1 -4 

ELSE Command, 2-113 

End-of -Data, 2-115 

End-of -File, 2-116 
,2-118 

ENDIF Command, 2-114 

EOD Command, 2-115 

EOF Command, 2-118 

EOJ Command, 2-119 

Errors 

During a Job Entry, 2-92 

During a Session, 1-10, 2-92 

In a Batch Job, 1-10,2-92 

In a Command, 1-10, 2-92 

In a Session, 1-10, 2-92 

In a User Defined Command, 3-11 

Establish a Logging Identifier, 2-156 

Executing a Prepared Program, 2-300 

Execution Options, 3-2 



FCOPY Command, 2-120 
File 

Altering Security on, 2-35 

Classes of, 1-13 

Creating, 2-63 

Deleting, 2-253 

Listing of, 2-188 

Renaming, 2-269 

Restoring Security, 2-306 

Saving, 2-304 

Security, Altering, 2-35, 
Suspending, 2-265 
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FILE Command, 2- 1 22 

Access Parameters, 2-130 

Canceling, 2-276 

Disposition Parameters, 2-133 

Example, 2-1 34 

Implicit, For Subsystems, 2-134 

Operation, 2-133 
File Designator Subsystem Formal, B- 1 
FOREIGN Command, 2-136 
Formal File Designators 

Used by Subsystems, 2-1 34 
Formal File Designators, Subsystems, B- 1 
FORTGO Command, 2-138 
FORTPREP Command, 2-140 
FORTRAN Command, 2-134 

,2-143 
FORTRAN Programs 

Compiling, 2-138, 2-140, 2-143, 2-146 
2-148,2-150 

Executing, 2-138, 2-148 

Preparing, 2- 1 3 8, 2- 1 40, 2- 1 50 
FREERIN Command, 2-145 
FTN Command, 2-146 
FTN Program Compiling, 2-146 
FTNGO Command, 2-148 
FTNPREP Command, 2-150 
FULLBACKUP Command, 2-152 



IF Block Termination, 2-114 

IF Command, 2-170 

IF Statement Alternative (ELSE), 2-170 

Initiate 

Batch Job, 2-172 

Interactive Session, 2-7, 2-161 
Input 

Paper Tape, 
From, 2-252 

Stream, End-of-Data, 2-115 
End-of -File, 2-118 
Input Devicef ile, 

Displaying Status/State, 2-328 
Interactive Session, 1-8 
Interpreting BASIC Programs, 2-46 
Interpreting BBASIC Programs, 2-54 
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GETLOG Command, 2-153 
GETRIN Command, 2-155 
GIVE Command, 2-157 
Global RIN, How to Free, 2-155 
Group 

Name, 2-164 

Passwords, 2-165 
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HEADOFF Command, 2-159 
HEADON Command, 2-160 
HELLO Command, 2-161 
HELP Command, 2-167 
HELP Subsystem, 2-167 



Conditional Execution, 2-318 
Current State, 2-335 
Displaying Status of, 2-335 
Setting the Value of, 2-315 
System Defined, 2-317 
User Defined Commands, 3-17 
User Defined, 2-317 
Values and Mnemonics, 2-316 
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Batch, 1-9 

Command Sequence Numbers, 1-9 

Controlling Execution Sequence, 2-170 

Name, in :JOB Command, 2-172 

Output Controlling, 2-174 

Status Displaying, 2-337 

Streaming, 2-382 
JOB Command, 2-172 
JOBFENCE Command, 2-177 
JOBPRI Command, 2-179 
JOBSECURITY Command, 2-1 80 
Job Control Words JCW, 2-315 
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Keyword Parameters, 1 - 5 



LDISMOUNT Command, 2-181 
LIMIT Command, 2-182 
LIST Option (UDC Declaration), 3-3 
LISTACCT Command, 2- 1 84 
LISTF Command, 2-188 
LISTFTEMP Command, 2-195 
LISTGROUP Command, 2-203 
LISTUSER Command, 2-208 
LISTLOG Command, 2-206 
LISTVS Command, 2-21 1 
LMOUNT Command, 2-214 
Lockwords, UDC, 2-310 
LOG Command, 2-216 
LOGOFF Command, 2-217 
Logging Files, 2-156 
Logging Identifiers 

Altering, 2-33 

Establishing, 2-156 

Listing, 2-206 

Removing, 2-268 
Logging Off the System, 2-70 
Logging On the System, 2-7, 2-161, 2-172 

2-164,2-172,2-7,2-7 
LOGON Command, 2-218 
LOGON Option (UDC Declaration), 3-4 
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Messages 

From the Console Operator, 2-320 
How to Send, 2-397 
OFF or ON, 2-320 
Sending to Console, 2-400 
Sending to Job or Session, 2-397 

MOUNT Command, 2-219 

Mounting Volume Sets, 2-219 



Name, at Logon, 2-163 
Nested Commands, User defined, 3-10 
NEWACCT Command, 2-221 
NEWGROUP Command, 2-225 
NEWUSER Command, 2-228 
NEWVSET Command, 2-231 
NOBREAK Option (UDC Declaration), 3-3 
NOHELP Option (UDC Declaration), 3-5 
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SOLDPASS, 1-15 

OPENQ Command, 2-233 

OUTFENCE Command, 2-234 

Output Devicefile, 

Displaying Status/State, 2-328 

Overriding 

Job Errors, 1-10, 2-92 



Parameter 

Delimiters, 1-4, 3-15 

Keyword, 1-5 

Optional, 1-4 

Types, 3-13 
Parameters Positional, 1-5 
PARTBACKUP Command, 2-236 
PASCAL Command, 2-238 
PASCAL Program 

Compiling, 2-238,2-240,2-241 

Executing, 2-240 

Preparing, 2-240, 2-242 
PASCALGO Command, 2-240 
PASCALPREP Command, 2-242 
PASSWORD Command, 2- 2 4 3a 
Password 

at Logon, 2-7, 2- 1 64 

Group, 2-164 

RIN, 2-158 
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Positional Parameters, 1-5 
PREP Command, 2-244 
PREPRUN Command, 2-247 
Processes 

BS, 2-173 

CS, 2-173 

DS, 2-173 

ES, 2-173 

HIPRI, 2-173 

Maximum, 2-173 
Program 

Commands, a List of , 1 - 1 2 

Execution After Break, 1-10 
Prompt, 1-4 

PTAPE Command, 2-252 
PURGE Command, 2-253 
PURGEACCT Command, 2-255 
PURGEGROUP Command, 2-257 
PURGEUSER Command, 2-259 
PURGEVSET Command, 2-260 



Quiet Mode (SETMSG OFF), 2-320 



RECALL Command, 2-261 

REDO Command, 2-262 

REFUSE Command, 2-264 

RELEASE Command, 2-265 

Releasing RIN, 2-145 

RELLOG Command, 2-268 

RENAME Command, 2-269 

REPLY Command, 2-271 

REPORT Command, 2-273 

RESET Command, 2-276 

RESETDUMP Command, 2-279 

RESTORE Command, 2-280 

RESUME Command, 2-288 

RESUMEJOB Command, 2-289 

RESUMELOG Command, 2-290 

RESUMESPOOL Command, 2-291 

RIN (Resource Identification Number), 2-145 

Acquiring, 2-155 

Passwords, 2-155 

Releasing, 2-145 



Rotational Position Sensing 
:DISCRPS Command, 2-44 

RPG Command, 2-293 

RPG Program 

Compiling, 2-293, 2-295, 2-297 
Executing, 2-295 
Preparing, 2-295, 2-297 

RPGGO Command, 2-295 

RPGPREP Command, 2-297 

RUN Command, 2-300 



SAVE Command, 2-304 
SECURE Command, 2-306 
Security Provisions, 2-306 

Altering, 2-32 

Suspending, 2-265 
SEGMENTER Command, 2-307 
Session 

Command Logon, 2-7 

Initiating, 2-161 

Interactive, 1-8 

Status Displaying, 2-337 

Termination (:BYE Command), 2-70 

Termination and Suspension, 2-11 
SET Command, 2-309 
SETCATALOG Command, 2-310 
SETCATALOG, Command 

Using, 3-6 
SETDUMP Command, 2-313 
SETJCW Command, 2-315 
SETMSG Command, 2-320 
SHOWALLOCATE Command, 2-320a 
SHOWALLOW Command, 2-321 
SHOWCACHE Command, 2-322 
SHOWCATALOG Command, 2-324 
SHOWCATALOG, Command 

Using, 3-1, 3-9 
SHOWCOM Command, 2-326 
SHOWDEV Command, 2-328 
SHOWIN Command, 2-331 
SHOWJCW Command, 2-335 
SHOWJOB Command, 2-337 
SHOWLOG Command, 2-342 
SHOWLOGSTATUS Command, 2-343 
SHOWME Command, 2-345 
SHOWOUT Command, 2-347 
SHOWQ Command, 2-352 
SHOWTIME Command, 2-354 
SHUTDOWN Command, 2-355 
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SHUTQ Command, 2-357 
SPEED Command, 2-358 
SPL Command, 2-360 
SPL Program 

Compiling, 2-360, 2-362, 2-364 
Executing, 2-362 
Preparing, 2-362, 2-364 
SPLGO Command, 2-362 
SPLPREP Command, 2-364 
Stack Dump Facility, Disable, 2-279 
STARTCACHE Command, 2-367 
STARTSESS Command, 2-368 
STARTSPOOL Command, 2-372 
Status of 

Currently Opened Logfiles, 2-343 
Input Devicefiles, 2-331 
Input/Output Devices, 2-328 
Jobs/Sessions, 2-337, 2-345 
Output Devicefiles, 2-347 
Status of Disc Drives, 2- 1 09 
STOPCACHE Command, 2-374 
STOPSPOOL Command, 2-375 
STORE command, 2-377 
Stream How to Stream Jobs, 2-385 
STREAM Command, 2-382 
Streaming Terminating Streamed Jobs, 2- 
STREAMS Command, 2-388 
Suspended Operation, Resuming, 2-288 
SUSPENDSPOOL Command, 2-390 
SWITCHLOG Command, 2-391 
Syntax Conventions, 1 -6 
SYSDUMP Command, 2-393 
System Defined Files, 1-14 
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TAKE Command, 2-396 
TELL Command, 2-397 
TELLOP Command, 2-399 
Terminal Speed 

How to Change, 2-358 

Sensing at Logon, 2-358 
Terminal Types, 2-165 
Terminals Supported by MPE V, A- 1 
Terminate 

Batch Job, 2-119 

Data Set, 2-115 

IF Block, 2-114 

Session, 2-70 



Program or Operation, 2-11 
Termtype 

:HELLO command, 2-162, 2-174, 2-369 

Logon, 2-8 
Time Limit (TIME-Parameter), 2-161 
Time, How to Display, 2-354 
Transmission Speed, How to Change, 2-358 
TUNE Command, 2-400 
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UDC (User Defined Command) 

Body, 3-5 

Command Errors, 3-11 

Command Name, 3-2 

Details of Operation, 3-9 

Errors, 3-11 

Functionality, 3-16 

Header, 3-2 

Modifying, 3-8 

Nesting, 3-10 

Parameters, 3-2, 3-13 

Syntax of, 3-2 
UDC File 

Delimiters, 3-15 

Generating a List of, 3-1 

Hierarchy, 3-1, 3-4 

How to Catalog, 2-310 

How to List, 2-310, 3-1 

JCW, 3-17 

List of, 2-324 

Lock words, 2-310 

Security, 3-6 

Using Editor to Create, 3-8 

Using Editor to Modify, 3-8 
UP Command, 2-403 
User Subprogram Library (USL), 1-14 

2-244 
USL FILE, Preparing, Executing, 2-247 



VINIT Command, 2-404 
VMOUNT Command, 2-407 
Volume Set 

Definitions, List of, 2-211 
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How to Dismount, 2- 1 04 
How to Mount, 2-219 
List of Users, 2-409 
VSUSER Command, 2-411 
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WARN Command, 2-412 
WELCOME Command, 2-413 
Wild Card Characters, 1-6 
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